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ABSTRACT 

A tyo-year experimont in educational computer usage 
and program exchange sponsored by the National Science Foundation is 
described in the body of this review. The purpose of tlie project was 
to set up a prototype organization of five university coipputer 
centers in order to establish a set of procedures that would 
facilitate the efficient sharing of computer programs among tb9 five 
centers. The main document in the report briefly describes: the 
reasons for having this kind of exchange program; the mechanics of 
ti... organization that was set up; the progr^^ss aade in the first two 
years of the project; a review of the probl. encountered in the 
moving of programs; and a set of conclusions d recommendations for 
those who may be involved in the moving of ptograms from one computer 
to another. The fifteep appendixes include discussions of a variety 
of related probleji) areas, and, together with the introduction, 
provide a valuable text that should be useful to anyone working with 
computers in the academic community. (WDR) 
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The Ic-utorhoad says CONDUIT. The places raontioncd aro Oregon 
State University , 0; Nortli Carolina educational Con^.putinq Service, 
N; Dartraouth College, D; University of Iov;a , UI; Tiie University of 
Texas, T. Their common concern: Computers, C. 

A line across the bottom of the page explains: *'An experiment 
in educational computer usage and program exch.ango sponsored by the 
National Science Foundation." Experim.ent means that the project ^s 
organization of people is a prototype. The first interest of tlie 
Foundation is to discover if this prototype is aii effective organi- 
zation. The first interest of the computer centers is in this 
prototype is the cxchaiige of programs. 

Those conflicting interests have been with tlie project since 
its beginning ir^ January of 1972 v;hen one persoj^ at each center v;as 
designated Coordinator. His (or her) tasks wore bipartate: first, 
move proyram.s; secondly, report on their moveiaent. 

A project director v/ith a staff of three was establisl^ied to 
ride liord on the disj^iersed coordinators. A psychological testing 
agency prepared to monitor the project's activity. The prototype 
was set: a cooperative of representatives from dispersed coiviputer 
centers coordinated by a small central office- 

To provide an iimediate focus for moving programs, six 
worksliops wore organi/:ed. To each workshop came tv;o professors 
from each of the five regions. After the workshops tlie teachiCrs 
returned [lome to try oat the nev; ideas v;ith their students. The 
computer programs accompanying these ideas wc^ro to he im.plom.ented 
in each region ]y/ the Coordinator and his staff. During the summer 
and fall of 1972, educational uses of the computer in Linear Algebra, 
Topics in Ph^'sics, numerical Metliods in Cl^emistry, Operations 
Researcli, llconomic Games, and Survey Analysis v/ere each the subject 
of a v;orksliop. 
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By June of 1973, students and teachers had used and endorsed 
these several and various methods of using computing in their 
courses (1). The project staff, however, recognized that serious 
differences between the five centers were inhibiting the flow of 
prograras , 

Differences over the mailing of magnetic tape and punched 
cards. Fortran and Basic dialects, standards for program docuraen- 
tation, and protocols for sending and receiving programs, all 
posed problems that could be solved • 

The second year of the project saw an organized effort to 
solve these technical difficulties. By the end of May, 1974, 
several documents published by the Central Office attempted to 
codify this effort (2-6). ^ 

In addition to the import and export of programs, each center 
made a collateral effort to find good new applications, to publi- 
cize them, and to encourage their use by whatever means seemed 
appropriate. This broad charge was freely interpreted by different 
individuals in different ways. One common thread running through 
the activities of all five computer centers was the regional work- 
shop, a one-day to one-week conference to promote a new idea in 
computing . 

While the project was funded from January, 1972 through 
December, 1974, its activities focused on the academic years 1972-73 
and 1973-74. This report is the final report of the Dartmouth 
office of Project CONDUIT and covers the period from the beginning 
of the project through May 31, 1974. The last appendix will contain 
late conments on the period June 1, 1974 to December 31, 1974. 



The Lay of the Land 

Before discussing the activities of the Dartmouth CONDUIT 
office, it is necessary to explore the terrain in which these 
activities were to take place. 

The computing environineut is conditioned by three fundamental 
convictions : 

1) Computing should be freely available to the whole 
campus community ; 

2) Computing should bo fast and easy to use; 

3) Remote users (customers) should receive" the same 
service f rom the machinery that on- campus users 
receive . 

These convictions led to: 

1) The development of a language, BASIC, that can be 
learned in a few hours; and 
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2) The development of a time-sharing system with 

several hundred terminals available at the user's 
convenience. 

When an individual works at a terminal, he can expect the 
computer to respond to his commands within loss than four seconds. 
The computer is extremely reliable; it operates smoothly more tlian 
99% of its scheduled 8:00 a.m. to 3:00 a,m, day. 

Because the computer is reliable and virtually everyone 
interested in computing on canipus is capable of getting on the 
compu t e r , aljiiost al l services to the user may be obtained on-lin e . 
There is a library of progrcims with files explaining their use. 
There are programs that explain many aspects of the system. There 
is an on-lino suggestion box where answers are guaranteed within 
twenty-four hours . 

The result of the BASIC language i the time-sharing system and 
the on-line services is a carr.pus population literate in computing. 
Some of the faculty and the majority of the students know how to 
write simple progran\s. A few remote colleges also have significant 
groups of students and faculty who are literate in computing. 



Two Fast Years : 1972-73 - 1973-74 

Not surprisingly, a few teachers have explored ways to use 
this new activity, computing, in their research and in their 
teaching, John Merrill in the Physics Department at Dartmouth took 
advantage of support from Project COEXIST to write a text entitled 
The Computer in Second Semester Physics . This text touches a 
variety of topics that crop up in Physics from the second semester 
on through graduate work: m.echanics, magnetic fields, relativity, 
to name a few. 

In June of 1972, John Merrill taught a two-week Physics 
Workshop. (This workshop is often called in the CONDUIT publications 
a "national workshop" to distinguish it from a regional conference, 
"local workshop,'' held by a participating computer center.) Upon 
its conclusion, teachers returned to Iowa, Texas, Oregon and North 
Carolina to begin the year's v;ork with his Physics programs. A 
complete report of this workshop is on file in the Central Office (7). 
Unedited version has been published by that office (8). 

By September, the Dartmouth office was importing programs to 
help the small band of eight teachers that had attended the National 
Workshops. This was not the full complement of twelve. Missing was 
a second mathematician, a second economist, and two teachers of 
operations management. Of the eight teachers, four - contrary to 
the original plan - were not being served by the Dartmouth computer. 
Robert D. Gillette taught Chemistry at the Naval Academy. All ties 
to him were through the U.S* mails » Similarly, Darrien Moore in the 
Mathematics Department, and Jorin Dawson and Richard St. Onge in the 
Physics DepartJtient of the ('niversity of New Hampshire were all cut 
off wh =?n the university sevorcd Its ties to Dartmouth and began 
working on their own computer in the fall of 197 2. 
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The four remaining teachers were served by the Dartmouth 
computer 

James Boyles - Chemistry Department, Bates College 
Elinor Hartshorn - Political Science Department, 

Mount Holyoke College 
George Michaelides - Economics Department, Franklin 

Pierce College 
David Rosenberg - Political Science Department, 

Middlebury College 

The trials and tribulations of the first year have been fully 
reported in the Interim Report, KnightF^ in Rusting Armour (9) - 
(The body of this report is Appendix N.) 

During the second academic year of tlie project, import 
activities decline, export activitieis increased, and marketing 
efforts slumbered. With no new round of workshops to stimulate 
demand for imported programs, the volume of imported programs 
dwindled. Two large programs were successfully begun: Prince, 
an international politics game from Syracuse, and a series of 
simulations in Epidemiology from Cornell (See (10-14) (17) and 
Appendix A) . Each was undertaken at the request of a professor 
at Dartmouth. Two more data sets were prepared for use on the 
IMPRESS system, and two more workbooks were prepared for use. 
(See Appendix A. ) 

Some of the first year's work was consolidated in drafts of 
future booklets. James Boyles at Bates prepared some notes for 
his students using MASSPEC, '7^n Experiment in Mass Spectrometry 
Utilizing a Computer Simulation of Mass Spectrometer.'^ David 
Rosenberg completely v;rote a workbook for his students using the 
IMPRESS dataset, CITIZENS. The booklet was entitled "Citizens 
and the Political Attitudes in Four Countries." 

The number of exported programs increased because of the 
need for trial cases for technical standards. Three program setr: 
were prepared to demonstrate the on-line export system (discussed 
below). CONDUIT also began to revise programs for COMPUTe texts. 

The marketing activities slumbered because oi a four-month 
absence of the project Coordinator. The available program sets 
were announced in the October issue of the center's newsletter. 
They were announced again a month later in a latter to the faculty. 
(See Appendix 3. } 

A quite successful Regional Conference on Computing took 
place in January. Some tape slide shows were made to demonstrate 
new uses of computing. An on--line bibliography of texts and 
booklets was polished and put into smooth operation. (See (18,19) 
Appendix I.) Contacts between the commercial publishers and the 
local office increased and the groundwork was laid for future 
cooperation (15). In May an adver tisen ent of the Huggins text 
was sent to over 1300 people. (See Appendix B.) 
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The solution to the technical problems began when the Chief 
Programmer from Dartmouth visited all five CONDUIT centers in 
July of 1973. His experience with magnetic tape and Fortran 
formed the basis for the first Programmer's Meeting. The meeting 
was held at Dartmouth on October 3-4; 1973. Subsequent meetinas 
of programmers and coordinators sped the development of techr.ical 
agreements. At Dartmouth, the coordinator and the chief progran\mer 
collaborated on a series of local working papers describing various 
aspects of this work. 

The second year's activity very clearly separated the CONDUIT 
problems of transporting educational programs into two kinds. 
There were problems CONDUIT could work through and the problems 
CONDUIT had to work around. 



The Solubl e Problem: Moving a Pr o gram 

"Moving a program from one computer to another 
is like moving a horse by train: fundamentally 
it does not want to go.*' (16) 



The first year of the project illustrated, if nothing else, 
how not to transport computer prograras. The first Interim Report 
treated in detail the case of some badly moved Cher^ustry programs. 
(Sec Appendix N, pp. 7--9,) The following mistakes occurred in one 
or more of those programs: 

..programs that produced incorrect answers wore selected; 

.♦programs that did not run were exported; 

..character codes were not shipped with rnagnetic tapes of 
progreims ; 

..printed copy of the programs was not shipped with the 
magnetic tape; 

..flow charts and S£imple data and sample runs were not 
sent v/ith programs. 



The first two mistakes wasted forty hours of a very skilled 
programmer's time. The next three mistakes cost another forty-- two 
hours of wasted effort. 

The second year solved these problems completely. Using a 
standard cliaractor code, and a standard magnetic tape format, (See 
Appendix C) , a program:ner successfully loaded four program sets 
from the four CONDUIT centers. Each set v;as loaded in fifteen 
minutes. After a set of programs v;as loaded, each individual pro- 
gram imported to Dartmouth was translated into BASIC. Exerpts 
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from the first year's report shows what some :>f this effort 
costs (9 , p . 3) : 



Computing Programmer Cost Total 
Cost ($ 2.00/hr) 

Business $342.18 $169*50 $511.68 

Linear Algebra 60.06 57 00 117.06 



Yet these efforts, while satisfying those who had attended workshops 
and were familiar with the programs, were not complete. To satis- 
factorily document those programs (internally) would have required • 
additional hours of prograiruner time. 

For example, both the Business and the Linear Algebra programs 
were embedded in a text. The Linear Algebra programs did not con- 
tain (and did not need, if used with the text) any internal documen- 
tation. Howevei:, if chese programs were to bf^ placed in a public 
library where they could possibly be used independently of the text, 
they would require the following extra v/ork. 



Computing Estimated* New 
Cost E xtra work Total 

Business $511.68 $20.00 $531.68 

Linear Algebra 117.06 24.00 141.06 



*(at $2.00/hr) 



These cOvSts could be avoided if prograiris were properly 
prepared for export. So, the programmers from the five centers 
established working agreements on two progrcumning languages, 
FORTRAN amd BASIC, {See (5) and Appendix F.) and on ideal program- 
ming style, internal program documentation, and the accompanying 
commentary. (The Dartmouth version appears in Appendicies D and E.) 

The Dartmouth office applied these standards to three program 
sets it prepared for export. The resulting costs are listed in 
Table 1. 
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Table 1 

Program Sets For Export 
(Figures for May 15, 1974) 



Huggins Merrill Reiner 



No. of Programs 2 60 16 



Program 


1 




59 


8 


Q-File 


1 




1 


8 


Lines of 


468 




5333 


1600 


Program 






Code 


71 




1762 


331 


Internal 










Comments 


25 




1684 


403 


Q-File 


372 




1887 


866 


Preparation 
Costs 


$192. 


92 


$316. 53 


$477.88 


Progremuner 


$ 84. 


00 


$165.00 


$231.00 


($3.00/hr) 










Computer 


108. 


92 


151.53 


246. 88 


Languages 


BASIC 


BASIC, FORTRTVN 


BASIC 













Price/Set $ 15.00 $ 25.00 $ 35.00 



The costs of the Merrill set is significantly less than the 
Reiner set because it was prepared after the standards for programs 
and comment files had been distributed to the local programmers* 

Another soluble problem was the routine export of programs. 
During the first year all requests had been handled on an ad hoc 
basis. During the second year of the project a fully computerized 
export system was implemented. It first ran successfully on 
April 15, 1974. (See Appendix H.) 

To help in the Fortran-to-Basic translation of the first year, 
a set of editorial aids were written. (See Appendix G.) During 
the second year some additional aids for translation from Basic to 
Fortran were developed. 
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The Insoluble Problem! Moving the Idea 

More important than moving a program is moving the idea of 
the program • The idea of the program is what the teache*r^or 
researcher values. }Ie must have a clear explanation of that idea 
before he is even willing to look at the program^ lot alone think 
of obtaining a working version. 

If an idea is going to travel any further than its originator, 
it must be written down. When the idea involves a computer program 
used in college instruction, what gets written down generally takes 
the form of a text, or text supplement. To write such a booklet 
will, in the current schen^e of tenure calculations, fail to advance 
an author's career and may retard it. So the first snag is 

the rewards for the author. 



Dartinouth COMDUIT worked around this problem by encouraging 
the efforts of a sister project, COMPUTo. COMPUTe provides authors 
with royalties for thoir efforts and produces much needed texts and 
text supplements on instrur;tional computing. (See Appendix J.) 
CONDUIT will be responsible for establishing standards for the com- 
puter programs in new COilPUTe texts and has undertaken to revise 
some of COMPUTe 's current offerings. 

The local CONDUIT office has also shov;n manuscripts to 
commercial publishing firms who could move texts by traditional 
methods. To date these efforts have been unsuccessful. (For 
reasons, sec (15).) After a book is published, it needs to be 
marketed. CONDUIT, through its five center connections, can con- 
tribute to this marketing of a booklet. 

But as one approaches the marketing of a booklet, one sees 
several other insoluble problen^s. VJhat one markets is the idea of 
the program. For a simple notion, a short program can be moved in 
a text. For a more complex idea, for example, a game the size of 
PRINCE, the program itself is the expression of the idea, and it 
must be moved. (The real achievement of CONDUIT has boen to solve 
most of the prol^lems associated with this movement.) But either 
the simple or the complex idea needs to be adjudged a good idea 
before it will be used. This judgement depends heavily on 



; the convenience of computing. 

The convenience of computing is a function of the local compu*- 
ter and the services of the computer center staff. The more 
inconvenient the computing, the greater the hardships for a compu-- 
ting idea as it competes for the instructor's attention. Even with 
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convenient computing, an idea must fit in with 



the content of the course. 



How a teacher composes his course determines what he decides 
he will need to teach it. Here, a computing idea must compete 
like all others for its proper audience. After Project CONDUIT 
removes any handicaps by making sure the associated programs work, 
the idea must then sell itself. And in selling itself, two more 
insumountable problems confront it: 



the abi li ty of the teacher and • 
the ability of the student . 



There will always be bright students and dull students. 
Nothing can be done about that. But what computation centers can 
do, again, is remove the computing idea's handicaps by training 
students and teachers in computing. Were this an accomplished fact, 
then "ability" would mean ac ademic ability not com puting ability. 
Project CONDUIT, by encouraging the computer center efforts to raise 
the computing literacy on campus, aids the struggling computing idea. 



Results 

The four major results of the Dartmouth CONDUIT office are! 

Moved Computer Programs 
*<eports on Activities 
Working Papers 
Computrized Systems 

Moved Computer Programs 

Programs fall into categories that deserve some 
explanation. First are progran\s available in the on-line 
library, CONLIB.(See Appendix K,) In this library are 
73 programs made available by Project CONDUIT to users of 
the Dartmouth Time-Sharing System. Most of these programs 
were not only imported, but translated from Fortran to Basic. 
Many of these programs form sets for a text. The following 
texts have 41 programs insCONLIB: 
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ClO/10 programs 



Harris, Roy D, and Michael J, 
Maggard, C omputer Models in 
Operations Management ; Harper 
and Row, New York, 1972. 



(18/21 programs) 



Johnson, K, Jeffrey, Nu merical 
Methods in Chemistry , {2nd 
Edition) Chemistry Department, 
University of Pittsburgh, 1973 



(5/5 program.s) 



McLaughlin, Donald A Computer 

Oriented Course in Linear 
Al gebra , Regional Computer 
Center, University of Iowa 



(8/8 programs) 



Reiners , V?illiam A,, William 
Glanz, and Stanley £• Cornish, 
Ecological Modeling on the 
Dartmouth Timc-Shar inc j S ystem , 
(3rd Edition) , Biology'"bepart- 
ment, Dartmouth College, 1973, 



This leaves 32 additional loose prograjns in economics and 
chemistry . 

Not listed in CONLIB but translated by Project CONDUIT 
are the five data bases for four social science workbooks 
used on the IMPRESS system: 



1972-73 

(1 data base) 



(2 data bases) 



1973-74 

(1 data base) 



Ch anging Attitudes Toward Integration 

1946-19C6 (IMPRESS Edition) , G.R. Boynton, 
University of Iowa, 1972. 

Voting Behavior in Western Europe, 
(IMPRESS Version) , Gerhard Lowenberg , 
University of Iowa, 1973, 



Voting Behavior in the United States; 
1952-1968, (IMPRESS Version) , G, R. 



Boynton, 1972 • 



(1 data base) Citizens and the Political System 

(IMPRESS Supplement) , to Citizens and 
the Political System , G. R. Boynton, 
Harper & Row, New York 
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ThG Dartmouth office promoted the casual export of 
the following books: 

1. Bauer, Richard S., Introduction to Time-Shar ing 

Applications in ^Banking , Kiewit ComputatTon 
Center, Dartmouth College, 1974. 

2. Huggins, Elisha, A Computer-Assisted Introduction 

To Mechanics , Kiewit Computation Center, 
Dartmouth College, 1973. 

3. Merrill, John R. , The Computer in Second Semester 

Physics , Kiewit Computation Center, Dartmouth 
College, 1972. (To be published by Houghton 
Mifflin. ) 

4. Olson, Maynard, Computer Calculation of Chemica l 

Equilibrium , Chemis cry Department, Dartmouth 
College, 1973. 

5. Reiners, William A., William E. Glanz, and Stanley 

F . Cornish , Ecological Modeling on the 
Dartmouth Time-Sharing System , (3rd Edition) , 
Biology Department, Dartmouth Colli^ge, 1973. 

6. Sokol, Robert, A Laboratory Manual for Introductory 

Sociology , Harper & Row, New York. 

7. V7illiamson, J. Peter and David {{. Downes, Manual 

for Computer Programs in Finance and 
Investments , (3rd Edition) , Amos Tuck School 
of Business, Dartmouth College, 1973. 



Computer programs for Olson are contained in the text. 
Those for Williamson and Bauer are distributed by the 
business school and the computation center. Sokol 's programs 
work on IMPRESS and on data cards. The three other authors 
served as test cases for the new documentation standard and 
export system. These three program sets are now for sale. 

$15.00 Huggins (2 programs) 

$25.00 Merrill (60 programs) 

$35,00 Reiners ( 8 programs) 
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Reports of Activity 

The project has produced nine reports listed below. 
Together they detail many of the experiences ot one office 
involved in a prototype cooperative. 



Table 2 

Reports of the Dartiuouth-CONDUIT Office 



1* A Rep ort on the CONDUIT Ph ysics Workshop Held June 
19-30 / 1972 at D artmou t h Collecj c, John mT Nevi'son. 
Internal Memoranduni Submitted in August of 1972 to • 
CONDUIT Central Office at Duke University. 

2 . Report on t he December 9th Social Science Worksho p 
at Dar tJi^out h^ John M. N evison. Internal Memoranda 
submitted December 20, 1972 and March 26, 1973 to 
the CONDUIT Central Office at Duke University. 

3 • Report on a V^orkshop: The Ki e wit- CONDUIT Cqn^f^o rence 
March 16-17, 1973, John M. Nevison. Internal* 
Memorandum subrnTtted May 17, 1973 to the CONDUIT 
Central Office at Duke University. 

4 . R epo r t on a Worksho p : IMP RESS at Welle sley 21 April 
1973 , John M. Nevison. Internal Memorandum submitted 
May 18, 1973 to the CONDUIT Central Office at Duke 
University . 

5 . Leading the Ho rse to Water: A Report on the CONDUIT- 
FIumRRO trial of a kit o £ social science booklets by 
users of t he Dar tmouth Time Shar i ng System , John M. 
Nevison. Internal Memorandum submitted in August 
1973, to the CONDUIT Central Office at the University 
of Iowa. 

6 . Classroom Rep ort: Polit ical Science , IMPRES S, and 
CONDUIT at Middlc bury 1972-1973 ^ David A. Rosenberg, 
July 19, 1972, submitted in October 1973 to CONDUIT 
Central Office at the University of Iowa. 

* Knigh ts in R ust ing Armour : A Re p ort on the CONDUIT 
Activities at Da r tmouth/ June 1 9 7 2-M a y 1 973^ (Inte rim 
Report) , John M. Nevison, October 1973. 

8 • Report on the Kiewi t-CONDUIT-COMPUTe C o nference . 
Janua r y 25-26, 197 4 . Christopher G. }Ioogendyk. 
Internal Memorandum submitted to CONDUIT Central 
Office, Iowa City on June 7, 1974. 
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9 • P roject CONDUIT at Da r tmouth Collccjc (Final Report) t 
John M. Nevison, Juno 1974. 



Working Papers 

During the second year, standards for the office 
operation were documented before r during, and after the fact. 
The eight working papers Ir.sted below specify the ideal 
operation of an import-export office. 



Table 3 

Working Papers of the Dartmouth-CONDUIT Office 

1. Preparing a Prograni for Export , Christopher G. Hoogendyk, 
April 19 74. 

2. Describing a Prograi^^ for Export , John M. Nevison, 
April 1974. 

3. Agreeable Fortran , Christopher G. Hoogendyk, May 197 4. 

4 . Editorial Aids for Importing and Exporting Fortran 
Progrcims on DTSS, Christopher G. Hoogendyk, October 1973. 

5. The Export System , John M. Nevison, May 1974. 

6. How Combib_Works , John M. Nevxson, May 1974. 

7. Magnetic Tape Form at for Exp orting Programs , Christopher 
G. Hoogendyk, May 1974* 

8. Programmer ^ s Weapons , John M. Nevison, May 1974, 



Computerized Sy s teiT\s 

Last and most important are the on-line systems that 
increased the office's efficiency. The major systems are 
discussed in detail in the working papers: 



1. The on-line library and its table of contents, 
LIBCAT. (See Appendix K.) 

2. • The complete reference system for texts and 

progreims on instructional computing, COMDIB. 
(See Appendix I.) , 
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3. The set of programs that provides editorial 
aid in program translation, import, and export. 
(See Appendix G . ) 

4. The system that makes possible prompt and 
versatile program export, (See Appendix H.) 



Conclusions 



A number of programs shipped to the computer center were not 
moved to class because they lacked an adequate description of their use 
in the cou'se. Of those that had adequate descriptions, only a few * 
were innovative enough to corrjnand any interest. Two lessons emerge 
from this: 

1« A computer center should not import a program w 
an adequate description of how ^o use it in a co.. 

2. A computer center 53hould not import a program unless 
a teacher has requested it. 

A variety of technical problems made the original import of 
some programs difficult. Had the programs been properly prepared 
for shipment this would not have occurred. The third lesson of the 
Project is 

3. A computer center should not import programs that are 
poorly prepared for shipment • 

The other side of that lesson is 

4. A computer center should not export programs 
improperly prepared for shipments 

"Proper" preparation has been defined in the working papers of 
the project. (See especially Appendices D and E.) Indeed, this 
definition is the majpr success of the pr oject. 

Work with these properly prepared programs has ?^;hown: 

5. It is possible to set useful standards for exporting 
a computer program. 

6. It is possible to export a program using these standards. 

7. Such a prepared program is at least an order of magnitude 
faster and cheaper to import (15 minutes versus 42 hours). 
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Program sets like those associated with the Prince books 
and the Epidemiology simulations were imported witThout benefit of 
the local hosts havincj attended any workshops* This experience 
indicates that 

8. An adequate written description of use in the course 
is more important to a program's dissemination than 
is a workshop. (It is also much cheaper.) 

Last and most important/ good ideas did move from the computer 
center into the classroom. There, each teacher had his own opinions 
about how to use a program and one observes that 

9. On an interactive computer, a library program will 
frequently be taylored to the needs of a particular 
course . 

While this tayloring was sometimes done by zhe teacher, one 
of his students often did it for him. This practice was so common 
that one can say that 

10. The student-teacher pair is a most effective team for 
bringing a computing idea to its ultimate fruition in 
the course. 



From one officers view point the Project succeeded. It moved 
programs and reported on their movement. It established local 
operating procedures that employed computerized systems when 
appropriate. It defined standards for program export and produced 
examples of these standards. In short, it solved tho^e problems 
v;ithin its focus and illumined those on its periphery. 
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APPENDIX A 



Technical Costs of PrograBi Set Preparation 
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The Problems o f Princo 

Prince is an international diplomacy game, written in 
Fortran, At the request of Professor David Baldwin, the Dartmouth 
CONDUIT office imported the prograni for his governinent course. 

In April, 1973 , the progreun was purchased from the 
International Relations Program at the University of Syracuse for 
$50.00» When it arrived there were problems reading the magnetic 
tape. Several phone calls to Syracuse cleared up these problems. 

The second set of problems were caused by the lack of suitable 
documentation of the program. There was no flow chart, no internal 
progrcim documentation, and no usable sample output. After a series, 
of phone calls, the description of the program ( a flow chart of 
sorts) c'rrived with some sample runs of the Syracuse version. All 
this engaged a prograinmer for about 40 hours. 

His next 46 hours were spent doing battle with the prograni, 
the local problems with Dartjiiouth Fortran, and the coro memory 
restrictions of time-sharing. The sub-program shifting in the 
Fortran run-time package would not handle moru than 24 sub-programs. 
Af*':er making extra efforts to demonstrate that the error was in 
Fortran and not in the program, the programmer convinced the student 
in charge o: Fortran to clean up his act. The programmer went 
home for the summer after 86 hours of work. 

In October, Fortran ran better and sub-programs were well 
handled. The programmer set about the next majr\ cask; shoe- 
horning a 30K {K is 1024 36 bit v/ords of core memory) progrcim 
into a 16K slot. First, he reduced the COMMON used by the program 
and shrank that work space from five thousand words to two hundred 
words. Next he broke up sub-progr anis into smaller units. Last, 
he closed each file as he was done using it and picked up 500 
words for each shut file. The program finally ran in 16K of 
core. 

What was saved in space was lost in run time. A 24K version 
ran in 50 seconds of CPU, but the 16K version ran in 200. 

The October-November efforts of the programmer took 80 more 
hours. At this point, the progreun was demonstrated to David 
Baldwin and turned over to him for final polishing an^ v.se in 
his class* He hired a student to work on these final details. At 
least one student did use the progr£im in his class this wint :. 
More work is scheduled to be done this summer. 
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Programmer Costs $498.00 

Computer Costs 200,00 
One Program 

Line s of Program 1810 
Code 1775 
Comments 35 



CONDIB 

The actual progrcunrring of the on-line bibliography called 
CONBIB went quickly The coordinator and the progranuner devoted a 
Saturday morning to the final design of the visible system. The 
progreunmer wrote the essential prugran^ in 15 hours. Editorial 
features were buit into the system in another 15. 

A second programmer developed an "apple-picker" progreim to 
produce both a catalogue and an annotated bibliography from the 
file. His efforts eventually ran to 40 hours. 

A third programmer prepared an alternate CONBIB to the 
director's specifications in five hours. This version was never 
examined for use by the director and was put aside. 

The schedule of events was impressive. The program ran 
three days after the early June Saturday morning. The editorial 
features ran completely a week later. In July a general invita- 
tion to use the system was mailed to others in CONDUIT, The 
coordinator sent out a catalog generated by the "apple-picker" 
in late September. The Director's suggestions were made in early 
November and a working version was completed December 2nd. 

The computer costs of this effort are crude estimates because 
the files that it used remained on-line and development efforts 
diffused through several user numbers. 

Programmer Costs $291.00 
Compu ter Costs 370.00 



Export 

* 

The Export system began in December of 1973. The coordinator 
specified the way it had to look to the user, and : programmer was 
charged with designing the system. (And altering the coordinator's 
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original user specifications if they could be improved,) Over 
50 hours went into designing and drafting a preliminary version 
of the program. it was then rewritten, entered and debugged in 
another 23 hours* 



Progr£immer Costs $219.00 
Computer Costs 100.00 



Prog ram Sets for Sale 



After establishing suitable standards for an exported 
progran\ and its accompanying Q-file of comments, the staff applied 
these guides to three sets of programs. Two, Reiners and Huggins, 
were already complete by April 10th. Doth needed minor additional 
revisions to meet the standards. 

Merrill's set was begun and completed after April 10th. The 
programmer had the advantage of knowing exactly how the programs 
should be prepared before he began to work. 



Program Sets For Export 
(Figures for May 15, 1974) 





Huggins 


Merrill 


Reiner 


Vlo. /Prog terns 


2 


60 




16 


Program 


1 


59 




8 


Q-FilG 


1 


1 




8 


Lines/Program 


468 


5333 




1600 


Code 


71 


1762 




331 


Internal 










Comn'ioiits 


25 


1684 




403 


Q-File 


372 


1887 




866 


Preparation 
Costs 


$192.92 


$316. 


53 


$477.88 


Programmer 


$ 84.00 


$165. 


00 


$231.00 


($3.00/hr) 










Computer 


108. 92 


151. 


53 


246.88 


Languages 


BASIC 


BASIC, FORT RAN 


BASIC 



Price/Set $15.00 $ 25.00 $ 35.00 
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CONDUIT 



KtEWIT COMPUTATION CENTTR 
OAf^TMOUrH COLLCGE 
HANOVCR NEW HAMPSHIRE 03?bl> 



November 8, 197 3 



Dear Colleague , 



On the reverse side of this sheet is reprinted an article 
from the October issue of Kiewit Coimnents, the Computer Center's 
monthly newsletter . 

I would like to take this opportunity to call the article 
and Project CONDUIT to your attention and explain what services . 
we can provide. 

The Project itself is a prototype cooperative of five 
computer centers located at the schools of the Policy Board 
members on the letterhead. The cooperative is charged by the 
National Science Foundation with oxchanc *_.ig educational computer 
programs and learning from this exchange how to improve transport 
of programs. Needless- to-say the intent of this program exchange 
is to improve the quality of instruction. 

The programs and the texts moved last year are all listed 
on the computer; Programs in CONLIB*** : LIBCAT (LIST) and texts 
in CONLIB*** rCONBIB (RUN). (Please feel free to suggest 
additional texts . ) 

Presently the Project has a staff of eleven part-time 
student (mostly) programmers. Those programmers, headed by 
Christopher Hoogondyk, might possibly be of some help to you. 
Should you have any computer programs to import or export and 
want assistance please give me a call at 646-2643. (Best time 
is 1:00-3 :00 pm. } 

In addition to the programming staif, the Project is 
preparing several guides for those who import and export programs 
A tape standard and character code has already been established 
for the cooperative and has proved very successful . Guides on 
programmer protocols and programitiing languages are in preparation 

I would be happy to answer any questions yov) might have on 
the work of the Project. In the event that I am out of town, 
Christopher Hoogendyk or Steve Waite , the Coordinator of User 
Services, should be c^ble to help. 



Sincerely , • 
John M. Mevison 

Administrator, Project CONDUIT 



Bl 



ERIC 



An ejipertmeni 'i edjc^tton^f compuref ui^ge .i^ti f pf 01^ ram ejtchjnge sponsored ty the N^tion^f Scrence foundjrron 



Kiowit Conrnpr.Ls Vol. 7 No. 2 October 1973 

CONDUIT AND THF DARTMOU TI! SYSTEM 

Users of the nartmouth Timo-Sharin^i^ Svstom wishing? to import computer programs for use in 
courses can use the farilitius of C;OM)i;['r\ an n\por\mont in oxchim^in^ educational computer 
prog-ams. The project's coortiinator at Darlnxnilh Jack Nevison, who can be reached through 
Kiowit (603-6*16'2G4:U, and there; are avaih^ijlo through the project a ruuubor of student assistants who 
havo had oxporionce in inipurtinK programs fron; either computing systems, The programs resulting 
from thoir efforts aro described in lX)NLIB**VLIiK:AT. which can bo LISTod, Olhor foci of 
CONDUIT aro in Iowa. North Carohna. Orn^un. and Tevas. whore (hero aro IBM and CDC machinos. 
CONDUIT has been involveci in oxportinx programs from Dartmouth to those centers as well as 
importing material from them, 

During this school year, CONDUIT has some funds to assist in paying student programmers who 
can work with faculty members in importing pro^:ranis from outside Dartmouth. Those programs and 
texts which have been approved bv CCJNDUIT committees m various disciplines will receive 
preference- A bibliography of l;ooks ijertuunit to the project can bo obtained by RUNniug the filo 
CONLIU***:CONHIB, Below is a partial list of the approved texts, arranged by discipline; moro 
information about them and the names of ptjople on the Dartmouth system who could answer somo ' 
questions about them can be obtained from Nevison at Kiewit. 

Business: Computer Augmented Cases in Operation and Logistics Management, by 
William L. Berry and D. Clay Whyl)ark (Cincinnati; Southwestern Publishing 
Company; 1972); some of the cases are running in BASIC, Computer Models in 
Operations Mana>joment. bv Roy Harris and Michael ). Maggard (Now York: IJarpor 
and Row; 1972); all of the models are running in BASIC. Those interested in these 
programs can contact Steven Lazarus at the Tuck School [b03-G43'3292). 
Qiemi^try: NumnricaJ Methods in Chemistry by K. Jeffrey Johnson (Pittsburgh; 
Chemistry Department University of Pittsburgh: n.'d.); all the FORTRAN programs in 
the book are now available on DTSS in BASIC. Computer CaJcalQtions of Chemical 
Equihbrfa, by Nfaynard Olson (Hanover; Department of Chemistry. Dartmouth 
College); includes easy-toAvrite BASIC programs. Interested chemists can contact 
lames Boyles at 207-784-4141 for information about the use of Johnsor s text and 
Maynard Olson at Dartmouth (603-646-2763) for information about his owm text. 
Mathematics: A Computcr^Oriented Coarse in Linear Algebra, by Don McLaughlin 
(Iowa City; Regional Computer Center, University of Iowa; n.d.); all the FORTRAN 
programs in this book are available in BASIC. Information is available from Barion 
Moore at the University of New Hampshire (603-B62-2321), 

Physics: The Computer in Second Semester Physics, by John Merrill (Hanover: Kiowit *' 
Computation Ceriter, Dartmouth College; not yet published); has simple BASIC 
programs. A Course m Computer-Assisted Mechanics, by Elisha Huggins (}Ianover; 
Kiewit Computation Center. Dartmouth College; n.d,)'; suggests simple BASIC 
programs. Merrill's work is being used at the Univorsitv of New Hampshire by John 
Dawson (003-^62-1395) and Richard St, On^o (603-862-2088) and at Dartmouth by Elisha 
Huggins (603-646-2969), Huggins can also be contacted for information about his te,xt. 
Social Science: A Laboratory Manual for Introductory Sociology, by Robert Sokol 
(New York: Harper and Row; n.d.); all the exercises in the book run on the IMPRESS*** 
system, and information about their use can be obtained from Soko! at 603-646-2637, 
Additionally, several workbooks describing elementary survey analysis have been 
translated from the Universitv of Iowa's Statistical Package for the Social Sciences into 
Dartmouth's IMPRESS***; booklets published by the Regional Computer Center. 
University of Iowa. Iowa City, and available through the Dartmouth Bookstore aro; 

Voting Behavior in VVestorn Eiiropo. by Gerhard Lowenberg; and Changing Attitudes 
Towards fntegrotion: 1946-1966. The Gti/en and the Pohticai System, and Voting 
Behavior in the United States: 1952-1968. all three bv G, Robert Boynton Somo of those 
booklets have bc^en used by David Rosenberg at Middlcbury College (802-386-2901); they 
are also described in the library file C0DFJ30QK***. 

In economics, somo proj^rams have been translated into BASIC but thoy need verification by an 
economist working with with a student programmer. Nevison can supply details at Kiewit. 
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ANNOUNCEMENT 



Computer Assisted Introduction to Mec hanics 
(270 pp. - $3.&<3) 
K 

Elisha R, Hugglns, Dartmouth Project COEXIST 



This text, available In paperback from the Klewit Computation 
Center at Dartmouth College, Is the result of the first semester 
mechanics effort of Project COEXIST. Through a coordl:iated use 
of text, laboratory, and the computer, the book Introduces Newtonian 
mechanics in six chapters. It can aerve as a short text on mechanics 
or be used as a text supplement in a regular physios course. Since the 
main benefit of a computer in physics is that a student can work a 
realistic problem of his own choice, we have a special chapter on 
student project work. Special plotting techniques allow all the programs 
to run on a minicomputer as v/eli as on a time-sharing system. 



Table of Contents 

Chapter I 
Chapter II 
Chapter III 
Chapter IV 
Chapter V 
Chapter VI 



Introduction to BASIC 

Graphical Analysis of Strobe Photographs 
Computer Analysis of Projectile Motion Experiments 
Newtonian Mechanics and Earth Satellites 
Project Work 
Special Topics 



The first chapter Is a brief introduction to the computer language BASIC. 
This chapter is written so students can learn both the computer language 
and the plotting techniques on their own, without the assistance of an 
Instructor. 

The text approaches mechanics through a coordinated use of strobe photographs 
and the computer. In both cases, the motion of an object iz broken down 
into short but finite time steps. We first use strobe photographs to help 
the student visualize this step by step description of motion, and then 
introduce a computer algorithm which allows the student to convert his 
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Strobe analysis Into powerful techniques for predicting motion. Since 
we remain with short but finite time steps, calculus Is not required for 
the student using this text. 

Chapter II Introduces the concepts of velocity and acceleration through a 
graphical analysis of strobe photographs of projectile motion. The chapter 
describes the laboratory procedures so that one can have students either 
take their own strobe photographs or use samples supplied in the text. 

In Chapter III the gr^^* hlcal definitions of velocity and acceleration are 
converted to the bds.c steps or algorithm for a computer prediction of the 
motion of projectiles. Programs aid the study of projectile motion both 
without and with air resistance, and the computed predictions are compared 
with the experimental results from Chapter II, The computer is also effective 
for the analyses of experimental errors. 

Chapter IV introduces Newton's second 'av/. With a slight modification of his 
projectile motion program, the student studios the motion of earth satellites 
and apollo spacecraft. These calculations are explicitly us?d to illustrate 
Kepler's laws and the laws of conservation of energy and angular momentum. 

In Chapter V on student project work, we show how the basic stmularity of 
all Newtonian mechanics problems makes it easy to convert a program from 
one problem to another. (For example, almost identical computer programs 
predict the orbit of an Apollo spacecraft and the path of a ball bouncing on a 
spring.) As an incentive and source of ideas for further project work, we 
review a variety of student projects* ^ 

Chapter VI consists of separate sections that can be inserted into the rest of 
the course as desired . Section I Is the computer analysis of a simple air 
track experiment. In Section II, the analytic solution of the harm.onic oscillator 
problem Is compared with the computer solution. Some calculus Is required 
for this work. The analytic solution in Section III of the damped harmonic 
oscillator should be challenging even to students with relatively advanced 
calculus backgrounds. Section IV investigates the motion of a ball bouncing 
and swinging on the end of a spring* This combination of a strobe experiment 
and a computer analysis provides a detailed check of Newton's second law. 



To order: 

send $3.75 (plus postage) to The Dartmouth Bookstore, Main Street, 
Hanover, New Hampshire 03755. (Postage: $.50/book; $ .25/addltlonal 
book to same destination.) 

Orders of more than twenty five (25) copies may be addressed to the 
Documents Clerk, Klewit Computation Center, Dartmouth College, Hanover, 
New Hampshire 03755. Please include payment with order. 
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Magnetic Tape Format for Exporting Programs 



This guideline describes a general format to be used for 
sending computer programs on magnetic tapes. 

Following is a brief summary of that format: 

1. 7 track 

2. 800 bits per inch 

3. Odd parity 

4. No label, no block serials, and no record 
control words 

5. Fixed length records 80 characters long 

6. Block length of 80 characters • 

7. 6 bit IBMEL character set 

This format is suitable for sending documentation, source files 
for computer progreims , and data in card image format. There are 
two exceptions that can be made to this standard, but they should 
be made only by prior ag reement between the two centers involved 
in the exchange. The first exception is in cases where additional 
characters, such as the lower case alphabet, are required for the 
material. This could be achieved v;ithin the standard by using one 
of the extra characters as an escape character, or the two centers 
involved might agree on a different tape format based on their 
own systems and an extended character set. The second exception 
is when the volume of material is either too small to justify 
using a tape, or too large to use an unblocked format. If a data 
deck is small enough to send in an envelope, then cards may be 
used as long as the card code is the hollerith code used by the 
IBM model 026 keypunch. {See description at the end of this guide- 
line.) If the material is too large to fit on one or two 2400 
foot reels using an unblocked format, then the two centers should 
make an agreement on a reasonable record size and block size. 
Just as a guide^ the writer was able to fit roughly 30,000 records 
on a 2400 foot reel using the COMDUIT format. By using a 40 records 
per block, the scime reel held roughly 230,000 records. Based on 
this example, a data set or collection of programs that is more 
than about 50 or 60 thousand lines or card images in length 
(roughly, 1000 printer pages if listed) could be written using 
blocked records. This should only be taken as a rough indication, 
and an attempt should be made to follow the standard before 
deciding to deviate from it. 

Each of the conventions of the CONDUIT tape format is 
discussed individually below. Technical details are fairly standard 
industry wide and should not require any attention from the 
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programjUGr ' s point of view. All technical or hardware specifi- 
cations should follow the ANSI standard X3. 22-1973. 

1. Nine track tapes are an innovation of IBM to facili- 
tate the use of their 8-bit EDDIC character set. Most non- 
IBM systeins do not use them and 3 of the 5 CONDUIT centers 
do not have 9 track tape handlers. Since all of the CONDUIT 
centers have 7 track handlers, this is the obvious choice. 

The 7VNSI standard X3. 22-1973 requires 9 track handlers 

so that the 7 bits for an ASCII character will fit in one 

frame. Although this raay be fine as a standard to raove 

toward , it is not practical tor current use • 

2. A density of 800 BPI seems to be a good compromise 
between the various standard densititns. All the CONDUIT 
centers can handle it. It was chosen over 556 BPI because 
some storage capacity will be lost by using unblocked 
records, and it doesn't make sense to waste storage with 
all the conventions. 

3. Odd parity is used because even parity requires the 
character code 00 to be mapped to something else to 
keep it from being confused with blank tape. The code 
00 is used for the space or 0 character in different 
six bit codes, and it is a serious shortcoming for it to 
be mapped into another character and thereby confused with 
that other character. 

4. The label, block serial number, and record control 
words are all very different from system to system. 
Although they add useful error checking for in-house 
tapes, between different centers they only add garbage 
and greatly increase the difficulty of reading the tapes. 

5. In the absence of a record control word the records 
■have to be some fixed length, and 80 is a logical choice. 
The 80 character record length is in keeping with the 
standard card size on card oriented systems. It also 
allows for the margin v/idth oi: the large majority of 
teletypes . 

Since standard Fortran only uses columns 1-72 and 
many systems use columns 73-80 of files or card decks 
for sequencing numbers, any materials written on tape 
in the CONDUIT format should only use columns 1-72 and 
reserve columns 73-80 for sequencing numbers. 
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6. Since some of the CONDUIT centers have word oriented 
systems and their word sizes differ, difficulties can 
arise in separating multiple records within a block. 
The easiest solution to this problem is simply not to 
put more than one record in a block. If the tape is 
treated a full block at a time, and excess at the end 

of the block is thrown av/ay , then this allows room for 
some slop at the end of the record to accomodate the 
differences in machines, 

7. Six-bit code can be handled by all the CONDUIT centers, 
but each has its ov;n code. The Dartmouth system uses 
9-bit ASCII internally, but has facilities for loading 
character tables to translate other codes. One of these 
other codes is referred to as IBMEL. The two IBM systems 
both use 8-bit EBCDIC internally, but have facilities 

for directly reading 6-bit BCDIC from 7 track tapes. It 
turned out that their 7 track tape BCDIC is the same as 
the code Dartmouth refers to as IBMEL. Since there are 
so many codes called BCD, this code will be referred to 
as IBMEL. The two CDC systems each have different 6-bit 
BCD codes. Neither of these systems have any facility 
for reading a tape in a specified format except by writing 
a program to handle such a job. Since this is the case, 
it is no additional burden to have a particular character 
table in that program. Therefore, the best choice is to 
use the IBMEL character code for transporting materials 
on magnetic tapes between tlie CONDUIT centers. A table 
of the IBMEL code is at the end of this guideline. 
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Following are some samples of how to work with a tape in 
the rccoiumended fornat at each of the CONDUIT centers. These 
samples are not intended to be exhaustive but should give a 
fair idea of how to deal with the tapes. 



Dartmouth College 
Honeywell G635 

Dartmouth Time^-Sharing System 



The G635 is a word oriented machine with 36-bit words. The 
record lengths specified in the background programs are in terms 
of words so that a record length of 14 results in an 84 charac- 
ter record on the tape. The resulting tape can be read at another 
center by specifying 84 character record lengths or by just 
looking at the first 80 characters of each physical record. 

The following background program will write a number of 
files to a tape: 

100 WRITE f ilel; f ile2; . • . f ileN 

110 FORMAT ASCII 

120 TO TAPE name-of-tape 

130 FOIWAT NLABEL;NSER?NrCV; 

140 FORMAT RECSTZ 14;BLKSIZ 14 ; FILREC ; IBMEL 
150 POSITION 1 

160 REPORT tape name-of -tape is on the counter 
170 END 

The next background program will read a number of files from a 
tape : 

100 READ filel;file2; . • .fileN 

110 FORMAT ASCII 

120 FROM TAPE name-of -tape 

130 FORMAT NLABEL ; NSER ;NRCW 

140 FORMAT RECSIZ 14;BLKSIZ 14; IBMEL 

150 POSITION 1 

160 END 
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University of Iowa 
IBM 3 60/6 5 
OS/360 



The following deck will print a tape; 

//jobname JOB (xxxxxxxx) , ^ name ' 
// EXEC PGM=IEBPTPCH 
//SYSPRINT DD SYSOUT=A 

//SYSUTl DD UNIT=TP7TRK,LABEL= {1,NL) ,VOL=SER=tpnarae, 
// DISP=(OLD,KEEP) , 

// DCB= (DEN^2,TRTCH=T,RECFM=F,LRECL=80,BLKSIZE=80) 
//SySUT2 DD SYSOUT=A 
//SYSIN DD * 

PRINT MAXFLDS=1 

RECORD FIELD=-{80) 

// 
Notes : 

1. To punch a tape use: 

//SySUT2 DD SYSOUT=B 

2. Use LABEL=(2,NL) for second data set on tape, etc. 

The following deck will transfer a card deck to tape: 

//jobncune JOB (xxxxxxxx) , ' name ' 
// EXEC PGM=IEBGENER 
//SYSPRINT DD SYSOUT=A 
//SYSIN DD DUMMY 

//SYSUT2 DD UNIT=TP7TRK,LABEL= (1,BLP) ,DISP= (NEW, KEEP) , 
// VOL=SER=tpname 

// DCB= (DEN=2,TRTCH=T,LRECL=80 ,BLKSIZE=80,RECFM=F) 
//SYSUTl DD * 

input card deck 

/* 



Notes : 

1. Use LABEL= (2 ,BLP) for second data set, etc. 

2. BLP ('bypass label processing') results in a no label tape 
exactly like NL but BLP, unlike NL, makes no test for the pre- 
sence of (standard) labels on the tape and thus allows the use 
of blank tapes or allows overwriting of non-blank tapes. After 
the tape is created it may be read at NL. 
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North Carolina Educational Computing Service 

IBM 370/165 

OS/360 release 21.6 



The following deck will read a file from a tape: 



//jobname JOB account , programmer , options 
// EXEC TAPEDISK 

//INPUT DD DISP= (OLD, KEEP) ,UNIT=7TRACK, 

// VOLUME=SER=tapename ,DCB= (RECFM=F , 

// BLKSIZE-80,LIIECL=80,TRTCII=T) ,LABEL= ( ,NL) 

//OUTPUT DD DSN=filename,DISP- (NEW, KEEP) , 

// UNIT=DISK,VOL=SER=ecslll,SPACE= (TRK, (1,1)), 

// DCB= (LRECL=80,RECFM=FB,BLKSIZE=6400) 

// 



The next deck will read a file from a tape and print it on 
the printer: 



//jobname JOB account , programmer , options 
// EXEC TAPEPRiNT 

//INPUT DD --repeat DD description as in above deck 
// 



The next deck will read file from a tape and punch it on cards: 



//jobname JOB account ,prograrpjner , options 
// EXEC TAPECAPJD 

//INPUT DD --repeat DD specifications from above decks 
// 



The next deck will write a disc file out to tape: 



//jobname JOB account , programmer , options 
// EXEC DISKTAPE 

//INPUT DD DSN=f ilename ,DISP=SHR 
//OUTPUT DD DISP= (OLD, KEEP) ,UNIT=7TRACK, 
// VOL=SER=tapename ,DCB= (RECFM=F ,LRECL=80 , 
// BLKSIZE=80,TRTCH=T) ,LABEL= ( ,NL),RING=IN 
// 
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The next deck will write a card deck out to tape: 



//jobname JOB account , programmer , options 
// EXEC CARDTAPE 

//OUTPUT DD --repeat DD specifications from above deck 
//INPUT DD * 

. . . INSERT CARD DECK HERIil 

/* 

// 
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Oregon State University 
CDC 3300 

OS-3 version 4.3 



The following Fortran program will read a number of files 
from a tape and save them. 



PROGRAM READ 

CHARACTER IN (80) 

INTEGER TABLE (64) , OUT (20) 

DATA ( (TABLE (J ),J= 1,6 4)= 4 8, 1,2, 3, 4, 5, 6, 7, 

1 8,9,0,29,4 6,12,11,30,10,4 9,50,51,52,53, 

2 54,55,56,57,6 3,59,14,63,4 7,63,32,33,34, 

3 35,36,37,3 8,39,40,41,63,43,4 4,28,31,63, 

4 13,17,18,19,20,21,22,23,24,25,63,27,26, 

5 60,16,42) 
EQUIVALENCE (IN, OUT) 

C FILE NUMBER 1 = MAG TAPE 

C FILE NUMBER 2 = FILE 

N=FFIN (60) 

DO 100 11=1, N 

READ (60,1000) FILENAME 

1000 FORMAT (A8) 

CALL EQUIP (2 , 8HFILE ) 
25 BUFFERIN (1,1) (OUT(l) ,OUT(20) ) 
IF (EOF (1) ) GO TO 75 
LEN=4*LENGTHF (1) 
DO 50 1=1, LEN 
J1=IN (I) + l 
J2=TABLE (Jl) 
IN(1)=J2 
50 CONTINUE 

WRITE (2,1001) (IN (J) , J=l ,LEN) 

1001 FORMAT (80R1) 
GO TO 2 5 

75 CALL SAVE (2 , FILENAME) 
100 CALL UNEQUIP (2) 

CALL EXIT 

END 



The above program could be run in batch mode using the following 
job file (it assumes the program is saved with the name READ) : 



CJOB , Job-number , password , message 

CEQUIP,1=MT tape-number AT 800 BPI NO RING message 

[FORTRAN , I=READ , L , R 

8 

EPOP 
EXPOP 
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SIGPOP 

RANDK 

COMPETl 

C0MPET2 

C0MPET5 

TUNDRA 

C LOGOFF 



The next program will write a number of files to a tape. 
It can be run using a job file similar to the first. 



PROGRAM WRITE 

CHARACTER IN (80) 

INTEGER TABLE (64) , OUT (20) 

DATA ( (TABLE (J ),J-= 1,64) = 10, 1,2, 3, 4, 5, 6, 7, 8, 9, 16, 

1 14, 13, 48, 28, 31, 62, 49, 50, 51, 52, 53, 54, 55, 56, 57 , 

2 60,59,45,11,15,46,32,33,34,35,36,37,38,39,40, 

3 41,63,43,4 4,31,12,30,0,17,18,19,20,21,22,23, 

4 24,25,31,27,61,31,29,31) 
EQUIVALENCE (IN, OUT) 

C 

C THIS PROGRAM IS DESIGNED TO READ A FILE FROM THE 

C CDC 3300 {OS-3) , MAKE THE NECESSARY CHARACTER 

C CONVERSIONS, AND WRITE IT ON A MAG TAPE 

C 

C THE ARRAY "TABLE" IS USED TO CONVERT "ORGBCD" TO "IBMEL" 

C WITH THE FOLLOWING EXCEPTIONS 

C 1 LEFT BRACKET TO QUESTION MARK 

C 2 UP ARROW TO QUESTION MARK 

C 3 RIGHT BR/^.CKET TO QUESTION MARK 

C 4 BACK SLASH TO QUESTION MARK 

C 

C THi: LINE PRINTER CHARACTER SET IS NOT THE SAME 

C AS THE INTEI^NAL "ORGBCD" CHARACTER SET. 

C 

C FILES ON THE MT ARE SEPARATED BY EOF ' S 

C THE END OF THE MT IS INDICATED BY 2 EOF ' S 

C 

N=FFIN (60) 

DO 100 11 = 1, N 

READ (60, 1000) FILENAME 

1000 FORf4AT(A8) 

CALL EQUIP (1 ,FILENAME) 
25 READ(1,1001) (IN (J) ,J=1,80) 
IF (EOF (1) ) GO TO 7 5 

1001 FORM.^T (80A1) 
DO 50 1=1,80 

. .-^l^IN (I) +1 
' J2=TABLE (Jl) 
IN (I) = J2 
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50 CONTINUE 

BUFFEROUT (2,1) (OUT ( 1 ) , OUT ( 20) ) 

GO TO 25 
75 CALL UNEQUIPd) 
lf!0 ENDFILE 2 

ENDFILE 2 

STOP 

END 
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The University of Texas at Austin 

CDC 6400 and CDC 6600 

UT2-D 



Working with CONDUIT tapes at Texas is similar to working 
with them at Oregon State. A Fortran program can be written 
to do the job. They have their own routines for dealing with 
character data and use them to spread the characters out in an 
integer array and then pack them back down into the output 
array. The same problem was iiolved at Oregon by oquivalcncing 
an integer and character array. The programs are not listed 
here because the x^eader should be able to got the idea from 
the Oregon State examples and in any case will need to write 
a progrcim of his own using these ideas- 
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This description of terms comes from a handout at the 
University of Texas Computer Center, from ANSI standard X3.22- 
197 3, and from con\mon knowledge among progranuners • It does 
not get into teclmical specifications and measurements on the 
grounds that these are fairly standard industry-wide and the 
average prograriLmer has no need for those details. Anyone who 
is interested can refer to the ANSI standards. 



Magnetic Tape. Magnetic tape is a uniform material one- 
half inch wide coated on one side with metallic oxide that 
can be magnetized to record data. The only distinction 
between nine track and seven track tapes is the handler 
that wrote the tape. What this means is that a "nine 
track" tape could be erased and then used as a "i:>even 
track" tape. 

Block (Ph ysical Record) . A block is a group of characters 
that is treated as a unit by the tape handler. It is 
written on the tape as a continuous stream of characters 
with a gap of blank tape before and after it. 

In terblock gap .( Inter-record gap ) An interblock gap is 
the section of blank tape that separates recorded blocks. 
This gap is necessary for the tape handler to stop and 
get up to speed between blocks. 

Logic al Record. A logical record is a conceptual subunit 
of a block. There may be one or more logical records per 
block. A logical record can be a card image/ a line in 
a teletype file, the entire block, etc. 

Frame . A frame is one bit position across the width of 
the tape. Since the tape is written with seven tracks, 
one frcime contains seven bits of information - six bits 
of data and one parity bit. 

Odd Parity. Of the seven bits in a frame six are used 
for actual data. The seventh is used for a parity check. 
When the frcime is written, the bits in the frame are 
counted. If the sum of the bits is even, the parity bit 
is turned on. If the sum of the bits is odd, the parity 
bit is left off. When the frame is read back the sum of 
the seven bits will always be odd. If the sum is not odd, 



ERLC 



it causes a parity error. This warns the programmer 
that the tape is not recording properly. 

File Mark « A file mark is a block made up of a single 
character. On any given system the some character code 
is always used, but this differs sometimes and most 
systems will recognize any single character block as a 
file mark. These are used to separate different files 
(progrcims , data sets, whatever) on a tape. 
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SECTION OF A RECORDED 
MAGNETIC TAPE 



file mark 



interblock yap 



block 




parity 
track 



Note: these drawings are not drawn to scale 
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IBMKL Character Set 
(referred to by IBM as 7-track Tape BCDIC) 



DEC. 


OCT. 


HEX. 


□JAR. 


DFC. 


OCT. 


HEX. 


CHAR. 


0 


00 


00 




32 


40 


20 
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01 


01 
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- Extra 


character 


should be 


avoided unless tna 


pped by 


previous 


agreement • 
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Card decks should use the model 026 IBM keypunch hollcrith 
code. The easiest way to check this is to punch a card with 
all thG characters on it and compare it with the card image here 



lllllllll ' • II I - '■ 

lllllllll II I 

II 0 0 0 0 0 0 0 0 0 0 fl 3 3 0 0 1 3 ^1 liiillll 0 9 3 n a *i 1 0 0 n I n |0 fl P 0 0 !1 0 1 3 0 ? D 0 0 0 0 0 ? 0 o 5 J C 3 (1 0 0 0 0 0 0 0 0 o' ? 0 

1 ; I « S i ; I ! :);'■:' ri s ■ • i . i.t. . . i ;:j ji .. .t r. o i : ii .; c !• , ■ v i: .j ,i ■. = ' !■,,=:> ■. ■ . >n,s c, i .itj :i •: ;i Ji 'i »■ .'i ■■ :) 
l|l M II II 1 |1 I M M 1 i M 1 I ] ! 11 |l M I t I I I I M I I |i 1 1 1 I I M ! I I 11 1 ! 1 I I I I I I I I I M I I I I I M i II I 

2 2 1 2 2 2 2 2 2 2 2 1 5 2 ? n n 1 2 2 n 2 2 2 2 1 3 2 2 ? 2 ? 2 2 2 2 ? 2 2 ? 2 2 ? ? ? 2 2 ? ? ? 2 2 ? ? ? 2 2 2 2 2 ? 2 2 ? 2 2 2 2 2 2 2 2 ? ? 2 r 2 

3 3 3 | 3 3 1 3 3 3 3 }| 1 3 1 3 3 3 ]|] 1 3 n 3 3 3 |3 3 3 3 3 1 n 3 3 3 3 ||||3 3 3 3 3 3 3 3 3 ] 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 

4 M 4 1 1 4 u n M I n J i 4 J 4 1 1 .rn 4 u 4 1 1 4 4 n 1 1 : ! I i : n i I ,) ^ 4 4 n ! 4 n J H -n 4 M 4 4 ^ J 4 4 4 N J n J M 

5 5 5 5 5 1 5 5 5 5 5 5 S 5 1 5 5 5 5 5 5 5 1 S 5 5 5 5 5 5 1 3 3 n 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 S 5 S 5 S 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 S 5 5 S 5 S 5 

6 6 5 6 6 S 1 6 5 6 6 6 n 5 1 6 D 5 3 5 S ^ 1 6 6 P 6 5 5 b FJ £ D b b b 5 b 6 6 6 6 6 6 6 G H 6 6 6 6 6 6 5 E '3 3 0 S 6 6 6 5 6 6 C S G 6 B 6 S ii S 5 V S 

I ' 11 11 1 lit! 11 1 1 n lii 1 n 1 1 iti 1 1 1 1 1 1 iti T 11 1 1 1 n 1 1 n 1 1 1 1 1 1 1 1 1 ] 1 11 11 n n ] 1] 1 n n ! 1 nil 

8 8 8 8 8 3 3 8 | e 3 3 3 3 ; 1 3 1 3 3 3 fi 3 ?" 13 3 3 8 3 3 3 3 r3 1 1 1 3 1 1 1 1 1 3 3 3 n 3 3 3 fl 3 n 3 3 8 3 S 6 3 3 8 8 8 3 8 3 3 3 3 

9 9 3 3 9 3 3 9 9 1 3 9 9 'M : 3 3 1 3 3 1 9 3 3 3 1 3 3 3 3 3 3 3 5 1 3 3 3 3 3 3 3 3 3 3 3 9 9 3 3 5 3 3 9 3 3 3 9 9 9 3 3 3 3 ? 3 5 9 9 9 9 3 3 9 9 3 3 1 
I J ) > s i ' i » ■ - ' > ■ i ■-' :f ;j ^; ;kj ;5 iM. <j t; ti <j i; t' c >K* J) )-.;■ J >j '^^^ ;,■ m 
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Introduction 

Moving a program successfully involves preparing the program for export, 
preparing the documentation for the program, shipping the source code with 
complete documentation, implementing the program at the receiver's site, and 
verifying that the im.plemented program provides valid results. The first stage, 
preparing a program for export, means structuring, coding, and documenting a 
problem in such a way that the programmed solution can be easily transferred 
to other computers, documented and verified. It requires a continual 
awareness of the problems involved in the latter stages of the transfer and a 
gue stlgninn, oXvLgJ^^^^ a s sumptions and_ practices since foreign 

computer environm.ent s may differ in ways surprising to the unsuspecting 
programmer. These guidelines deal with practices and procedures for the pre- 
paration of a program, that make the entire transfer run more smoothly. 

Before deciding to export a program, however, it is reasonable to ask 
whether that program. ouc|ht^ to be exported* Evaluation for possible program 
transfer involves comiparing system characteristics such as machine speed, 
accuracy, core space, and special system features (e.g. graphing capabilities). 
Real differences on this level m.ay make transfer impractical or undesirable* 

General 

A primary consideration In preparing a program is readability . A programmer 
other than the one who prepared the program should be able to pick it up, read 
It, and understand it as quickly and easily as possible. This consideration is 
inherent in most of the practices and procedures described in the following 
sections. Programs must be written in a standard applications language such as 
Fortran or Basic, and simple algorithms are preferrable to cute or tricky ones 
unless efficiency dictates otherwise. A program should be thoroughly commented 
and well organized in a structured or modular manner whenever possible. Read-- 
ability is important not only v;hen exchanging programs with other systems but 
also when programs are transferred to or maintained by other programmers on the 
same system. 

Another important consideration is the ease with which a program can be 
Implemented on another system. This militates against assembly language and 
non-standard language features or sy:item routines. To meet this problem, a 
programmer cannot rely soley on his own system's manuals. He must read and 
refer to standard specifications of the language and even look through manuals 
from other systems. 
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FinaHy, the oaso with which the transferred prograni can be debugged 
and verified must bo considered. This requires such things as specifying and 
checking allowed ranges for input parameters, specifying required accuracy 
where It is critical, and again proper program organisation. 

The above three considerations apply both to programs that are being 
written for the first time and to programs that have already been written and 
which require modification to meet these guidelines. The following sections 
will deal with specific programming practices. 

Program Preparation 

The following discussion of programming practices Is divided into six • 
ba sic idea s: 

1. Use of a standard language 

2. Modular P^-ogramming 

3. Structured Programming 

4 . Parameterization 

5. Ease of verification 

6. Documentation 

At a minimum, a program that is going to be transferred should meet these 
guidelines for language, recognition of machine dependent and external routines 
(under modular program.ming) , complete test materials (under verification), and 
documentation. Whenever possible, these guidelines should be met in every 
respect. Furthermore, anyone developing new programs which will be transferred 
should follov/ these guidelines in every respect. 

!• Use of a Standard Language 

Using a standard language such as ANSI Fortran or Ba sic . increa se s the range 
of potential transfer of a program. A program v;hich is written in assembly language, 
or in a locally developed applications language, obviously cannot be of much use 
to other computer installation. Even when a standard language is used, the 
programmer has to be careful not to rely solely on his own center's documentation* 
Knowing what is standard and v;hat features are system specific depends on reading 
and referring to standard language specifications (/\NSI documents or the multitude 
of beginners manuals by McCracken) and reading manuals from different kinds of 
computer installations and comparing them with the local docum.entation . If a 
program requires the use of a nonstandard feature, then that code should be 
Isolated in a module and its purpose explained in internal program comments. 

2. Modular Programming 

Programs should be v;ritten in modular form based on function and machine 
dependancy. Proper program organization can be achieved most easily by planning 
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ahead and flowcharting the problem at a high functional level. After this has 
been done coding the problem becomes much easier. 

There are several reasons for writing programs modularly. If machine 
dependent code is isolated in a module whose function is clearly described in 
comment lines, that module can be more easily replaced by an equivalent 
module at another installation. This reduces the amount of time spent receding 
and simplifies the task of debugging and verifying the program when It is 
transferred . 

The primary core in which a program runs can be utilized with or without 
overlay techniques depending on local resources and system design. Typically, 
a batch system with lots of core can run very large programs, while a time- 
sharing system is much more linUted in the amount of core any given program 
can use and needs to overlay subprograms to fit a large program into its 
allotted core. If a program is written using subprograms as modules and 
doesn't have any excessively large pieces of cod., that are not broken into 
modules, then it should be able to run in either of these environments without 
requiring major redesign and receding of the program. It should be noted here 
that program controlled overlay is not standard and should be explained in 
comment lines if it is used. 

Another advantage of modular programming is that if a programmer uses 
standard functional iriodules in his programs he reduces the amount of time 
required tc develop the program. When the program is transferred implementa- 
tion time is reduced since the receiving site can substitute their own modules 
where necessary reducing the amount of unique code that has to be deciphered 
and debugged . 

Modular programming also increases the readability of a program and 
reduces the time required for someone else to decipher and understand the code. 

3. Structured Programming 

Within each module the logic flow should bo organized in a simple, coherent 
manner. This m.eans that a page of code should not be a maze of GOTO's with 
various lines of code inserted as an after-thought . Structured programming also 
refers to the visual layout of the page. In this sense it means using m.eaningful 
variable nam.es and utilising the width of the page through indentation so that 
the program can be read more easily. 

4 . Parameterization 

Parameterization should be used to eliminate explicit references to physical 
devices, character codes, and other system dependent features. Meaningful 
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variable names ?;hould be used in the place of recurring constants, These 
variables should be assigned values at the becjinning of the program and comment 
lines at that point should describe their purpose. This makes program transfer cr 
modification easier. In the case of device numbers, for example, only one line 
needs to be chancjed rather than locating all the RD\D's and WRITE' s and replacing 
them . 



5* Ease of Verification 



There are several ways in which the problems of verification can be made 
easier. Besides follov/ing all of the above considerations, input data should 
be checked and informative error messages printed out if they are out of range 
or in any way unreasonable. Limitations on input parameters and expected 
accuracy for all possible data should be explained in accompanying documenta- 
tion as well. When a progiari) is transferred, all necessary documentation for 
testing should be sent with it. This includes a description of all program options, 
input data for all paths and options, output for ail sampie input, and a listing 
and explanation of all program generated messages. Testing at the receiver site 
should include error paths and those extreme cases v/here machine accuracy might 
degrade either due to computational tecnniques or due to wod size incompatibi- 
lities. 



6. Internal Program Documentation 



Documentation is an important part of program, preparation and a necessity 
for the smooth transfer of programs. All of tha information in the following 
sections should be included as com,ment lines in the program itself. For a 
description of additional documentation that should accompany a program when 
it is transferred, refer to 'Describing a Program for Export. " 



a. Fog ram Header 



There should be a standard header of comment lines at the 
beginning of the program. This header should include; 



i. the mnemonic or calling name of the program, 

ii. a description of the program's origin and subsequent 
modifications stating author, date, language, machine, 
and operating system for each version, 

lii. a short abstract describing the function or purpose of 
the program and its output, 

iv. instructions on how to use the program and any options 
offered by the program, 

V. a description of the important variables used in the 
program. This can appear as a table of the variable 
names with a brief description of tho functions they 
serve in the program . Either part iii , iv, or v of the 
header should include a description of the allowed 
ranges for the input parameters. 

er|c 4 



vi. an explanation of any subroutines, system routines, 
data sets, or files required by the proc/raai that are 
not a part of the source deck itself. This section 
should include a description of any interfaces with 
other programs or routines and oi the format of anv 
data sets or files used. 

b. Module Header 

There should be a standard header of comments at the beginning 
of every module. This header is a brief form of the program 
header and includes the following items: 

i. the mnemonic or calling name of the module, 

ii. a description of its origin and subsequent 
modifications if that description is different 
from the rest of the progreim (this would apply 
to machine dependent modules that have to be 
completely rewritten at each installation), 

ill. a short abstract describing the function or 
purpose of ihR module and if it is machine 
dependent, an indication that it is with any 
necessary explanation of how to convert it, 

iv. a description of the module's interface with the 
mciin program indicating the entrance and exit 
conditions and parameters, 

c. Instruction Comments 

Comments within the program and all modules should describe 
any statements that deviate from the language standard. They 
should also be used to describe the function of any instructions, 
algorithms or equations involving unusual coding or complex 
logic, 

d. Program Logic 

Comments within the program and all modules should describe 
the organization and flow of logic through the program. These 
comments should be designed so that a programmer who is 
unfamiliar with the program can read through it quickly and 
easily and be able to understand wnat the program is doing. 
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Check list of Things to Watch For 



I. Machine Oriented Items. 

1. Does the new machine have the language in which the program is 
written? Is their version of the language standard? Are all the 
necessary functions and library routines available? 

2. Is the core si^e of the new machine adequate? 

3. Are word and byte size of both machines the same? If not, will it 
make a difference ? Is the precision of the new machine adequate? 

4. Does the new machine have tape handlers and the ability to read 
the source deck from an outside magnetic tape? Does the program 
require the use of devices (e.g. plotters) that may bo unavailable? 

5. Will the speed of the now machine be adequate to run the program 
efficiently? 

6. Does the program require the use of characters that may not be avail- 
able on the new machine? For example, a machine that uses a 6-bit code 
will not have lower case alpha betics. 

II. Program Oriented Items 

1. ^Has the program been written with consideration foi these guidelines? 

2. Has the program been thoroughly and successfully tested on your 
machine ? 

3. Have all variables been initialized in the program ? This should be done 
even if your current system does it for you. 

4. Are you sure that the correct source and documentation are sent 
together? Are they up to date versions that agree with what you are 
running on your system? 

5. Are non-integer numeric comparisons made using range of magnitude 
rather than absolute matches ? For example, if you assign A the value of 
1 . -{1 . 5^. 5)/2 . 0 it may come out as 0.0000001 and a subsequent test to 
see if A is equal to zero v/ould fail! An alternative would be to test the 
absolute value of A to see if it is less than 0. 000001 or v/hatever range 
is suitable. 
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6. If you depend on any internal repre-- taiion of your machine its 
use should bo isolated to one module and code 1 in a way that is clear 
and easy to modify. F'or example, if you are using a character code, 
do It through a lookup table. 

7. Avoid any condition or construction that is left undefined by the 
standard for the language you are using » For example, in Fortran 
the expression A**B**C is undefined and may be interpreted as either 
A**(B**C) or (A**B)**C. In this case put in the parenthesis to 
specify exactly what you mean. Another example is when the argu- 
ment of a computed GOTO in Fortran is less than 1 or greater than 
the number of statement numbers given. In this case the computed 
GOTO should be preceded by a conditional to handle those cases if 
they occur. 
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100 RI'.M 
110 RILM 
120 RILM 

130 ri:m 

140 RHM 

150 R!.M 

160 RI.M 

170 Rl-.M 

180 REM 

190 RI.M 

200 R1:M 

210 Rl-.M 

220 \U'M 

2 30 RiiM 

24 0 RILM 

2 50 RUM 

260 ri;m 

2 70 RliM 

28 0 Rl'M 

290 Rli.M 

300 \\m 

310 RliM 

320 Rl-.M 

330 RliM 

34 0 RIAt 

350 ri;m 
360 ri;m 

370 RllM 

38 0 ri:m 

390 Rl-.M 

4 00 RBI 

410 RHM 

4 20 RiiM 

4 30 RliM 

44 0 RBI 

450 RHM 

460 RHM 

4 70 RHM 

4 80 ri-;m 

4 90 Rl-.M 
500 REM 
510 RHM 

5 20 RHM 
5 30 RHM 
54 0 RHM 
5 50 RHM 
560 RHM 

5 70 RHM 
580 RH.^t 
590 RHM 
600 RI.M 
610 Ri:^( 
620 RI.M 
630 RHM 
64 0 RI.M 

6 50 RHM 
6 60 RHM 
670 RHM 
68 ~ 

69E^j 
710 



PROCRAMX -- (BASIC PROGRAM STARTS AT HI.NH 72 0) 

VHRSrO.N' 1: WRTTTi:\ UY PRO]'\, Do DUCK, UNIVHRSTTY 0|- OIVHRTY , 

QWHRTYVn.LF. , USA Oimpl),, LAST MODTIMHI) DHC i:Mr.l-;R -1, T.)71. 
WRITTI-IN IN I'ORTRAN' Li:VI-.H C FOR TllH, IBM 360 , 

VHRSTO.\ 2: MODIFIHD BY HD HORSH, COIVTOIVN, USA 80808, 
RAN' IN FORTRAN' VHRS . 21,5 FOR THii CPC 6400, FAS T 
MODI FI FT) APRIL 16 , 1 9 72. 

VF.RSIQN 3: TRAXSFATF.D RY M, MOUSIi, DARTMOUTH COLLHGH, IIAN'OVHR 
NJlo 037SS. RUNS IN D.'XRTMOUTIl F^ASIC SIXTH HDITION ON 
A IIONliYl'.'liLL G63S, DARTMOUTH T IMH-SILARI NG SYSTFi.M, 
USHS 8192 WORDS OF 36 BIT CORIi AND 2 SHCONDS OF CPU TIMi;. 

THIS IS YF.RSION 3. HAST MODIFIHD JANUARY 13, 1973. 



DHSCRIPTION: 



HHRF, IS A CONCISH DliSCRIPTlON OF THH PROGIUMS FUNCTION 
PURPOSH, .-VND OUTPUT. 



INSTRUCTIONS ; 

HHRH IS THF: I.N'FORMATION NliCHSSARY FOR SOMiiONH TO USli 
THF. P'^OGIUM. THIS CAN F.ITHHR BF. A COMPLF'TF DIISCRIPTION OF 
IIOV; TO USH THt: PROGR.\M, A RF.FliRRFNCH TO .\ MANUAH AND \\\mui 
IT CAN UF. GOTTHN, OR JUST A NOTH S.AYINC THAT INSTRUCTIONS ARIi 
GIVHX IVHHN THF PROGRAM IS RUN, 



PROGRAM NOTITS : 

TARHF: of IMPORTANT VARIABHliS 

i: ii ii ii -k -k -k ^ -k :h :k k k kkkkkkkkkkkkkk 



TABLHfSO) - - TABLH OF . , . 

TOP POINTHR TO TOP OF TABL 

INDl ■-- I.NDICATOR FOR . . , 

INPUTilO) -- USHR INPUT PAR.VNIHTHRS 



HTC . 



THIS PROGR.V! USHS A DATA FILH TH.\T IS A RANDOM ACCHSS NIPIFRIC 
PIHF.„ SUCH A PIIJ-. IS Sl.MlFAR TO A DHCLARIT) ARR,\Y IN THJi PROGR,\M 
BODY IN THAT TllH NUMBFIRS STORFJ) IN IT CAN BP- ACCJISSF.D 1-ROM ANY 
POSITION i;iTHIN THF LIST, HOKFAMIR, A FILL. IS USFD BLCAUSi; THF 
NUMBllR 01- i:.NTRIHS IS TOO LARCH TO FIT IN CORli AT ONF TIMH, IT 

IS Nr;ci;ssARY to havf: somi: structurh th.vf can contain up to 

20000 NIPIBHRS AND FROV! WHICH THOSH NUMBIIRS CAN BP ACCF;SSF.D AT 
RANDOM, THF. FILH IS NJIMBliRFJ) FROM 0 TO N- 1 , WHliRH N IS THH 
NUMBHR OF HNTRIHS„ 



ACCUR..\CY SHOULD BF. NO PRORLF.M SINCH INPUT PARAMFTHRS ARH 
INTP.GP.RS THAT R.\NGF UP TO ABOUT 20000, AND TllHRH ARH NO 
CRITICAL CALCULATIONS THAT MIGHT D['.CAY, 

********************* 
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Descri bin g Prog ram For Export. 

In an author's ov;n class, his tort may make even simple program 
documentation unnocessaiy. Similarly, on it's original computer, a well-- 
annotated interactive program may require no explanation beyond how to 
begin. But often a gap exists between the well documented program and the 
author* s description of how to use it in a course. 

As soon as a p rogram is moved frorn one computer to anothor, this gap 
widens * Several new questions confront the programmer who is importing the 
new program: Where is the program from? What does it do? How can one be 
sure It works correctly? 

To answer these questions a small file entitled Mechanics of Use will 
bo enclosed with each program or set of programs exported from the CONDUIT- 
Dartmouth office. The actual file name will be the program name followed by 
the letter Q. For example, PROGNM v/ould have a file on its use named 
PROGNMQ. 

The file, Mechanics of Use, should be written after the orogrammer has 
completed his internal program documentation and has briefly reviewed the 
author's write-up on hov/ the programs are used in a course. 

The goal of Mechanics of Use is to span the gap from the program to the 
text so that a program.mer at a remote site can m.ake the program usable in the 
course . 

The file should contain: 

1, PROGNMQ 

2, Title, ''Mechanics of Use For: 

3, The name of the authorCs) of the file , 
4 • The date la st modified and by whom . 

6, A full reference to the text which the program accompanies, 
(with cost and how to order) 

7, A full list of the programs and subprograms 

8, A list of the current locations where the programs work, 
(Language, machine, place, person) 

9t A graceful, intelligent discussion designed to ensure 
that the recipient can make the program v/ork in the 
course for v/hich they were intended. 
10. Sample input and output, data or special tests necessary 
to Illustrate the discussion. 
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EXAMPLE 



: COPYK ICJHT 1974, b!Y THE THUSIEES OF DiRir-OUT^i CCLLEGr ♦ 



. >ECHA^:^CS, OF use for:. PLOT .A^D THE ^OTMEH programs I^i the HUGGir^ • 
;':"TEXT.. ' . ■ [■ r. ' ^ 

... : VOFSCH I PTjO:;4 W^S OH I G I NiLLY I TJETi 3Y EL i Sh: HL-GG INS. ^ 
l-t: w Z\S. :VOPJf :I ED:;^^ D AV ) D ' Cl'ULEY - ON J A^^U AHY Z3n07A^ . ■ \ 

L AST MUDIF IC^T ION by JOHW ^ i:.; :NFV I SO^ on 3: APR IL 1974. . 

TEXT: EL I SHA : HUGG l:NS J CON^PUTEK /iSS I STED J N T DUC I f 0^! f 0 MF CH if^ I CS ♦ 
COPYHitGMTv TKUSJEES. OK\,DAKTXCUTH COLL EGE >: 272: PP*?r372 . ■ 
COST: : i:V.^(^.:FPO^* COCUMEA r.^CEf; T E f:» : k ! t '.V t J:' COMPU T iT i OiV CEfvTERf 
; OflKT^^OU T H; COLLEGE* h fl?gO VE k » 'iH V 37 5 5 • 

r " ♦ ■■■ ♦ , ' 

; y£C AUSE OF SH ACp L 1-^^ I T AT I ONS ThF HF ADEi: FOrt T>i^ P^OGRA^' ^ouLH 
....:^J0^ be njCLUOEO a I.Tfil^^: TmE: hko meiIe: ■ ■ - / 

... .:VEWS ION.; 1: V^R LTTEM:- BY EL I SHA ■;^L/GGTNSV. PHYS I CS ;DEPAHT?^EMTf OARTMOiiTM ; 
. ■■■:C0LLEGE-J :-HANOVEK<«^ "Nfl ^■37S;5 

^iOniFfEC FO'v PROJECT :CONJDU !T.HY OAVID^ COOLEY ' J/^^UARY 1974 w ':■:;;"; 

\ ,": THIS IS v;ERS:IO>J; ,1^: ; 1; AST^^ JO^N v. ; nf v | S0^^ . h APR M.^^^ 

' ■ .. DES.CR I PT ion: ; T;rl I.S: PKOGftA^r IS-i THF GE^iEKAf: UT 11 I T Y PMOGS AM TH AT ;. ! ^^^^^^^ 
PLOTS. ON A T FL F TY PE T^F f.H^^SUL T S: 0 F :PkO Gf^ am? v'^:i j T E^'i BE ^^T ^i^ I MG- ■ 
HITH- A LINE ■NUKBEk G HE AT E R T w Afr 1 ^^{^ . J HE FOWAT OF T»^ES^ ^ :■• 

pkogkavss , I s D I sci'SSEO I N : JDFT: A iL ) N ; : T HE /HUG G I ^js T E X T • / : . 

INSTKUCT IO^cS: f:a;jT A I \£D ' I N ^ECHAM CS ; O F USE AND . I N . T F^ T • ^ l 



THE FOLIO;: \ :iy}. 0 1 Smss |0N I S ^ADD^ESSFD; TO THE PPOG^^ Av "Pl.OT" " ■ . ^ ■ 
:>;:i^H I Ch: Appf Arf=S Ob ^AGF, S :0F T HF TE y T • ■ T MF hJFMA-| N 1 mg ^?an,yf[f^S ' AHF : ' ' 
> ; AVAJl A^LF J ^^ . T>^ rn be WK I T TEN .eY jMP STUOE'iT* 

: ^PIOT 'l A PK'O f;H A V U 5i ETV T ^.^^0 f /G HO M T : T^^E TF>:T TO: t:'POf?''CE STf-fO^f^ ;A^n ■ . 
;,v:.0^<^ i'T:;;PL67SV IT ;| S HE S I 0^]:^ H T'"' : WOP W novpii TEPS " aF l/I;'^ I T F^ ST>-»PAGf^ ■ 
i'CAPAC I TY^ .: .iTO PLO T A MUL T I.- V AfED MJ^CT I OAi» IJ IS ^E'i^FSSi^-^-^Y TO STCPE TH^^ 
: ■ -PO i.VT.S iAS- .t,HEY :a»vc .CALCHLATEO A^iO : T *^F^' P^ f ^'T OUT T*^E. Pf OT all'" AT oilCE* =~ 
.■::.T>t! S IS;N:.::CE5S AwY >^0k: FUNCT I ONS >H I CH : PHODUCE GKAPHS HAV IVG BOTH POS I - ' 
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^■TlVfc; A:iD.=MEGM.lV£. GLCPES i;S THE TELETYi't CiN NO! kOLL CjiCK 7 liC: fiREiV.- • ' 
UWS fiJOGKiM- ;.!iC..LC:.*:- C;:C .'..I L.r. S.IMKLlhJ.ED -'-G GilOnTLr.ED^'o CO.ve'iKtj Wllh 
TME- OrflOIN.'iL ,TC' ..'sEDL'Cc: TM5; STO.^AGc-.KcOu I r:EME..'< r j>- i.'.O. V "^KE IT CCMP; F IM l ' 
WITH TME N:GST;-.CLEKE\T.Af<y:,ru.<f..L 0 K " BAS I . .".S A. nEGoLT/IT SHOHL O^^KU:;- Ou 
.4;Nr 3IV I CC^>•^^'T.pf. , . : ^ 

. "HLOT'V HAS; 3EEV ;^RlTTEr/ Cf; L liJES oVe ' I h;<OUC M M Y- E 1 GH T AND 13 
USED. AS SUCH \>i THE. USER VS :PKOGr< A;/. ,, T,'iE L'SEfC ' 3 FUi'VCT 1 C,V PRO DUG I .VG PRO- ■ 
: CRAK .BE6I>\S.;.AT LIfiE-.-!kJ3 •AND. /JUr:HS 3AC;; TC THE i'L C T T I N G PROGR Av. 
■TO PLOT. TiiE .GRAf'Fl. ..|.\ TiilS, V.'AY .THE PKOGftAN- . CAN HE UCEC Crr A:;Y CGMPUTER" 
HAVING, dAS.IC and it .DOES: ?.CT :RELY ON S^PEC.IAL SUB.YOUT I K I fsO'c^AP A- IL i TIES. 
.:WHEN::«C.rKlM.6 SITH LARGE X'UM^^ERS 9P STUDE'-JIS: ON : A v i \ I ' COMFU TER ' IT .••'.AY ' 
b£ , CO.'n'E?J lEVT TO. HAVE T!;E : "SCH A TCh CO;.'.:.; A,\0 NO D I F I EO SO THAT , J T W ILL ^ 
,^0T E4ASE THESE flHST 93 L ir.-ES. ■ THEr.' THE PL 0 T T I G PR OGivAM CA^^8E 
;LEKT ,1?^ THE; M ACHIfiE FOK :;E PE A IE D US E b Y : S T.UDE ^T S..; : : . 

, THERE AHE SE V ER AL ; ^' 0,D I F I C AT 10 M S D F THE PHOGRAf^ W^HT CH T ,ME I NS TRUCTOP 

:.;NAY- a' I.Sri TO XAHE.. IF A LARGER :CO.VP'J;TES; IS USED*. IT ^VAY: CE CC'/vCJ I E', T ' 
/TO CHANGE, TH£..PfiOG.HAV..:.rC A .GU -JRCUTI KE >!S >AKE ADVANTAGE CF THE SfiCHINE'S^ 
. SUbHOUMMlNG -•J;iPAd!L.:rT lES.^ SO'-'ET l-MES A PK' IM 1 fJG: ■ERr;CH MAT OCCUR •DUP ING 
.-■■THE : PLOT. bECAUSE :A. PART I CULAR T E HV AL W I L L^ WV HANDL E A FULL 72 ' - 
-CHARACTER LI .--iE. THIS Ekl^CR CAN: RE : IL i:-- 1 ATE D ■■.By:. C H A\ 3 I :;C T HE V AR I ABLES ^ 
WHICH CONTROL THE PHYSICAL: SIZE OF THE PLOT. \".LSO THE- UGER f'AY i;'l5H TO ' 
CHANGE. THE , PRINTING CHARACTERSOK T HE LA b£L I •>! G CF-THE AXES. THESE 
.r<O.OIFl:GAT IONS WILL 3E :-:K I E'-'L Y. DES CR I EE D ; A:j Y 0 T HE R S W I L L BE LEFT UP TO ' 

: TO -THE: usE-R. \: . " : ■ , : '•:.■.;::,. ■ 

:.".HLOT:" .AS A SUHROUTINE: V ' ' 

;. IF ;ThE PLOTT:|NiG PROGRAM IS:.:T0::BE TREATED' AS A .SUBROUTI NE» THERE ^ 
-vAKE: THREE D;l ST INCT PIECES^ iiHICH C Arj ^ fiE :t RE A T E-D A S : T HREE GE P AP A T E • 
SUypCUT INES.; ;.T:!|£. FIRST f^. WHICH CORRESPONDS :T0"GOSUy i(V SfiOUi O^CONTA I \ ■ 
...LINES 2^-13. •«.I:TH;L:IN£ 8 DELETED.: T H IG SE CT I On I N I T lAL 1 2E S V aR iAP.i: ES » ■ 
:..CLEAR£S THE; STORAGE VECTOR. Ar;D :CALCUL AT:ES .SCALE :FAGTCRS. ^ Ti^E SECOND. ■ 
L CORRESPONDING TO. ."OOSUb Zv'" SHOULD CON T A | N : L ;i:nES .'1 9 - 27 FO L L OWED BY L INES " 
.5r-64...'. THIS .SUbROI'T INE 'WILL: STORE ; T HE PO: IN T S : 'AS T HEY. APE C AL CUL AT E 0. ' ' 
..THE. TH;|R0» GORREGPONDI-NG TO' "G05UB 3iV'" SHOULD. CONTAIN LINES 3^-^8 ^ 
.FOLLOWEO::HY: LINES 6:b-96. THIS SECT ION W ILL PRINT OUT THE FINAL PLOT. . 

..CHANGING: THE PRINT, CHARACTERS : . „ 

.c .THE; STANDARD PRINT: GH.ARACTERS IN "PLOT" ARE iN AS T E R ! SK C P 1= " 

AWO AN ■"OH" (P1=2). THESE CAN 8E CHANGED =BY REPLACING THE ♦ IN LINE ' ' 

.87 AND: JHE: "OH" . I N: LINE : 30' W I TH T HE DES I RED CHARACTER S. FOR EKAVPLE' 

.;T0. .HAVE THE. COHN'flNO: "LET, K1 = 2" PR 1 N T A PER I 0 D» L i NE : 8 9 « OUL D BE COME " ■ 

-■■■■OO I H] T . " , If 'j . . '" . 

".■ :' ■■ . . . . ■ ■ ■ ■ ^ . ■ ' .: , ■■ ■' . ■ . ■■■■ '..■ . ■ : 

KELA.HEL i NG AXES 

THE .FINAL: MODIFICAT !0\ DESCRliyED HERE I ST HE RELABEL I NC OF THE^X 
.AND; Y AXES.: THESE: ARE REL ArfL ED sY: REPL AC 1 NG THE X AND Y I rj Ll*'"^":^ >.i ■ . / 
AND .69 WITH THE DESIkEO LETTERS. :IT IS ESSENTIAL TO LEAVE THE "sPACE IN 



:FHONT OF THE :L ETIER . I N ; L I .\'£ 6.9 IN ; anOEH. TO V 4 I :j T Ail Tf!C ■CC'CRFCT LOCaT ION 
OF, THE VEHTICLE 4X I S. . j HE: S P a CE tiEFORE :T ME 1 E T IE H 1 N L I \'E 4 1 S I fPL Y 
•.LEAVES THE SPACES, SEEN L^E F W.EE^J ■ T HE , X • S , I N T HE :PL 07 S . iHlSCi^ 8E 
..OELET.ED: IF- OES IHED.:- ■ ■ ■ ' 

^■TELETY:P£::COQf<O.Ii^ATES ■ ' ''W:'-: )<■■:■ ^■ 

S I NCE; THE TELET YPE PR I N T Si 6 L I N E S PEH l^iCH AND li; CH/*PACT'^HS^ pcu, v; .i 
-INCH ALONG ;TH£:LINE»: A 7X/ TELETYPE PLOT COfiT A I NS 4 2 L I ^JES OF^ 70 CHH'- 

ACTERS EACH. THIS; PrtOGKiy. USE S T HE V AKl a &L E' 01 (OH OrjE ) T 0- ^ ^ ■ 

.LABEL THE, HOWS: FfiCM ZE KG { T QP KOW )■ 4 1 » AND THE VARIASLE 02 (OH TWO) - 
.TO. LAUEL, THE, COL.L'f^N'S FROM ZE^O (LEFT -MOST .COLUMrJ): TO 69. THESE^ VARI ABLES 
(01 A.\0 02) IDEM IFY EVE.^.Y PC irn TN THE PLOT AND FOR:-' WHAT ARE CALLED ■ 
THE ••TELETYPE; COOkD I N ATES" OF THE POINT. 

BEFORE; THE POINTS AHE CALCULATED* THE USER ENTEHS THE KAMQC OF MfS 
PLOT AND THE PKUGrtA^ T HE N C AL CU LATE S ; T HE : SC AL E iP AC T OP S PE OU I RED T Q: 
CONVERT FKCV THE USEK'.S' COURDIfJATES TO T HE T E L E T Y PE.: COCK D I N A T E S . ■ T HE - 
CALCULAT I0\ OF .THESE SCALE FACTORS I S THE .^.A ! N PUkPOS^ OF T HE ^1 rj I tV "L ' 
'*GOSUt^ U;.«: fAkT OF:: THE: PkOGRAh. : : ,-V.■v 

WH5M THE : CO/'! PU TE.W COMPU TES :-A : P0 I ^JT . ■ THE "GOSUti 20" HART OF T H*^ ' 
PKOGtyflM FIRST COiNVEHTS FkOW; T HE U S E K ' S COOk D I N A T E: T 0 T HE TELETYPE COORO- 
■lUMf UNO THEN, SrOKFS THE ^^Oli'iT I N S T OR AGE VE C T OP 0 { ).. -TilE GKEAT - 
, AD.VANT.AGE OFv: US ING. TELETYPE COOROIfvATES TO: STORE TME ::rCiNT I S THAT A - 
TELETYPE COC:;Di:;ATE WILL >JCT EXCEED T'^O DIGITS* W H I L E T HE USER S 
CCORDI.NATES ,.VAY BE ,E IGHT D l,G ITS. ■ ..M AfJY ^:OP.Z POL\'TS CA,*J BE STOKED l,V A ^ ' 
GIVEN STORAGE, VECTOR BY.. F IRST RQUf.DING OFF TO THE CC KI^E C T T E L E TY PE^ 
C30R0!:\'ATE;THA.'., 2Y STGRIN'G £ 0!^ 8 F ! GURE NUM 3ER3. : 

THE PLOTTING PROGRAr C AN ., PRI ^T A i 3L ANK »■ AN AST ERT SK . : OR AN: : ^ 
"Oil" AT ANY OF THE 42 X 7^ = 294J POINTS OF A 7X7 PLOT. THIS MEANS IT ' : 
.HAS TO STOrtE UP TO N£ A;<Ly 9(:;i;?. P IECES OF INFORMAT ION IN i TS STORAGE ■ 
VECTOR. YET.THE WHOLE PROGRAM: INCLUDING THE ROCr-V S'A VED FOR ST OR AGE • 
SHOULD NOr.:.EXCEED: TRJi! WORDS IN ORDER TO BE USED 0 N ^:AN : 3 K M I N l ' 
COMPUTER. ..^(TYP I CALLY T HE B AS I C COMR I LER USES UP. TO'SK WORDS' AND THE 
.USER.; IS LEFT . W I T.H 3K OR LESS. ) . : BY US ING A "BASE 3" STCR ING TECHN I QUE» ■ ' 
ALL 9i^i*y BI.TS OF I .NFOHM,AT I ON: ARE ..S TORE D : IN THE- VECTOR OC '):X' KICH HAS " ■ ' ■ 
ONLY 21i; COf^PONENTS.v THE;."DIM" COMMAND I N L 1 NE IMRE E:^:SAVE 5 :R00^^ FOR ' ■ ^ ^ 
.THIS-. VECTOR. ■ 

..BASE 3. STOR.AGE./ ; ::■': :. '":.,' . .: i..,. -,. ^-^ ■ 

ESSEN.riAL.rO: THE STORAGE T E CP.N I QUE i S T'hE FACT: THAT -EVEN THE SV AL--- 
L £S T . K I N 1 . GO V PU T EH S: USE :3 2: . B ITS: T O . S:T 0 R E . A F L 0 A T I N G P 0 I N T NUM BE R ( AL I ■ ■ ■ 
BASIC COMPILERS .USE :,FLO AT I NG P0,l NT ... NUM BERS ) . : OF THESE 32 BITS. 7 ARr 
USED F0:< THE • DEC I «:AL PO IN T;. 2 FOR ^HE: S I GN ' Ar^D PARI T Y » AND 23 ^ARE LEFT ^ ' 
FOt^ STORING ..THE. NU.M!J,EW. : T HUS AN Y : NIJM HE R SM AL L EH THAN- 2**23 I S STORED 

:EX ACTLY. W ITHOUT .ROUNDOFF.: THE. I DEA: IS TO P A CK^ AS MU CH 1 NF OPM AT 1 0 Vj AS" ■ 
POSS I BLE ..INTO: T H I S; NUr^^.ER. S I NCE . 3 ..PIECES OF . i NFORV AT'I ON ABCU T EACH > ' --^^ 
POINT ARE STCkEO* I T IS I HPOR T AN T T 0 KrJOsJ T H AT : 3* ♦ 14 IS LESS THAN 2»«'3» 
AN'O THUS .:..I,S .ST O.KE^p..,;£X ACTL.Y. . . . .,-:.-,. . ' .T;- 

T 0 IILUST.R AT E>: T HE ST OR AGE ' PRO CE DUliE* SUPPOSE ONE WANTED THE CbMPUTER 

;TO :PR INT :OUT ; THE. FOLLOW ING "iiLOCK" OF 14 NUMBERS 



id 1 2 3 4 5 6 :7 8: 9 It! 11 12 ,13 ; 

{r i£ : i£- 2 .a •£ ^ 2 ■ : 0 .t.V: 2):' 

LABELING THE PO S I T t CMS OK T HE SE NUK BC H 5 FKOM ZE KO T 0 :i 3 ( FROM LEFT TO 
RIGHT)* WE KIND a "1" IN THE: POSiTlO.NS ZEIiO iNU 7» A "2" \U POSITIONS • 
2 AMD 13» Ar;0 "2" ELSEWHERE.. NOW SUPPOSE THE FOLLOW I .NG NUf-^SEK I > 
ST:OREO, IN THE: STORAGE vector: ■ ' 

. 1«3**W >^2*3**3 >: 1ft3*>7 > 2*3**13 

SINCE IT :IS SMALLER THAN; 3** I-". IT W I L L E S T 0 KE 0 EXACTLY. AT^D ALL THE 
INFORKAT ION needed: TO HEHRODUCE THE BLOCK OF NUM 3EH S W I L 1 BE CC NT A I N ED 
IN IT. 

: VISUALIZING THE STORED FOR^I 

l«3*»j > 0»3»* 1 > ■^•3**2 + 2*3**3 > 3*3«*4 * 2*3**5 + ... 

THE. EXPOi'.'ENT OF THREE GIVES THE PC S I T I 0 N I N T HE , BL 0 CK » AND THE 
CCEFriCIENI^ 0l-:TMHEE IS THE ..NUKL'E,-; TO- l>-c PRINTED: -THERE*:. HOWEVER.: . 
INSTEAD OF; IN r i!.5 NL'VuEKS THE PROGkANv COULD PR I N T A' LiL ANK FOR 2» 
A KCH 1 J ..AND "CH".;;POK 2. .: T HE- RESULTS I S: ■ 

^ t! 1 2 3 4 5 : 6 7 8 9 10 1 1 12 1 3 
(•13 * 0) 

WHICH OF COURSE COULD BE T4 PO i N T S 1 N THE T E L E T Y PE PL 0 T . 

TO: USE: THIS S I 0 R AC E T E CHN I OU E I N : THE PL 0 T T I N G PRO GR AV. » EA CH LI NE 
OF 7^ CHARACTERS IS 5K0KEr. DO'^Jfi INTO E 6L0 C'.'; S 0 F , 1 4. PC I N T S E ACM. SINCE 

A 7 X 7 INCH plot: HAS 42 LINES-' THE ENTIRE PLOT CON T A I NS 5 *4 2= 2 1 i' SUCH 

bLOCKS. A^iD* SINCE EACH bLOCK CAN BE STORED AS ONE NUf-'.UER (COMPONENT) 

OF ■ THE STORAGE, VECTOR; A STORAGE V ECT 0 R ',v I T H 2 1 Si? COMPO NEN T S I S AIL ^ 
THAT IS NEEDED. 



TELETYPE PLOTTING SUMMARY 
A) STEPS 

: 0): START YOUR PRCORflM AT : L I N E 1 ;Ji) OR 1 AT E R. : ■ 

.. . ■• -1 ) SET THE SCALES OF THE GRAPH BY DEF I N INC T)IC VAR 1 AGLEC 

(X3»Y3)» (X9'Y'j;» AND ( X5 J Y.S ) . DEF I NE X4 ONLY IF YOU WISH 
: TO L IM 1 T THE PO I NTS ::PLOT T"! :r PER GKAPH. NO.'.f USE THE , 
-:.■ ,.COWMAND "G0SU8 Ik)" TO INIT I AL I Z E : T HE:-PLO T T I N G : SU BRO U:T I NE . .. 

., -a),-: DEFINE THE CUOKDINArES: X1» Yl OF THE: PO.INTER to: BE STORED,* 

■^: STATE THE PLOTTING CHAHACTER PI (1 :FOR: "•";. 2 FOR •: "0 " ) ♦ AND 

. ■ ■ . REPLACE THE :"hRINT" COM.X AND . W I T H :"G0:SU 0 , 22 " . ■ !F YOU WISH ' 

TO HAVE THE VALUES PR INTED OUT PUT THE. "GQSU3 2l'" , CCr-.f-' AND . . 
OM EITHER SIDE OF ^^E "PRINT" COMMAND. 

?) PLOT THE STORED POINTS. BY ADDING THE C0"VAND "GOSUE 3i3" 
flFTEH.:THE CALCUL AT IONS ARE :FINtSHEO. ^ ^ "GO SU 8 3 " ; 0 FT EN . . . 
:-■-.-.. APPEALS JUST *jEFORE THE "EN 0 " ST A T EM EN T . : 



: «) , OO'/NOT USE ANY OF THE 0 ("CH") V flR I ABL ES, SUCH AS 0 1 » 

. ,02» « »,. » 09» 0,( ) J,N YOUR FHOGK AV,* T HCSE 'AkE USED BY T HE : 
/- PLOTT ING ^PHOGHArs/;;>'^.:- ^: 

'■'\: 1) (X3>Y3) = COOhOINATES OF THE LOWER LEFT CORNER OF THE PLOT; 

Z) .(XStYg) '= COOKDINATES CF-THE UPPER :« ICHT'CGKNER OF THE :: ■■ 

J-'.- ■ • ■ i . ■ PLOT .. ^v;;;' / : ' : ■.: : \, ■ , 

-■ :3). .(X5»r5)' = PHYS 1 CAL DiyE';sior:s» ; IN i:nchesUf the plot.^ ■ ' ; 

: ; : : THE PLOT CA?r SOT; ^EXCEED 7 ; X" 7 ^INCHES. , ■ : ; . ^^ 
: /4:);" PI = .:P» irjTlNG VARI ABLE* : P1 = r PR I NT S ; 'V» 'V ^1 = 2 PR I N T S; :"0''«^ 
5) :X4- = MAXIMUM NUMSEft^ OF POINTS PER PL^OT (SEE BELOWX . 

;^C); speci"al^.feat,uhes.,: ■: 

} ^) TO EKASE STOkED PO I NT S FOR A SECOND PLC T I N ONE PROCR AV » - . - 
\ USE "G0,SUB:;1k?"V 

; 1)10 L I r* I T T HE NUVbER OF. PO I rj T S PER PL C T » USE T flE V ART ABLE 
; X4, BEFORE "GO^UBIi^". \? = : 1 » T HE GO VPUT EU W I L L : i " 
^■ ■ . STORE UP T 0 : 1 L-'i; PC I N T S AM T HEN PH I r; T T HE PLOT.: IT THEN 

ERASES THE MEVORY; AND S T AR TS.S T C HI N G T HE ' NEXT 1 L^i! POINTS 
; ; .Of THE S A^-e:^ FUf-;CT:ION:« " THIS AL L OW S A ; COMPL I, C AT E D: fLO T T 0 

6E SEPARATED -IMTO SEVERAL S I VPLER ONES ■ = 

j; FOLLOaM.NG: . I A SA^fPLE RUN. ,T HE U SE i-: C AL LS UP THE, ■ PROGRAM ''PLOT " 
■AND: THEN TYPES IN HIS O'.^N PROGRAM STAHT ING.AT LINE Ik^t'. HE THEN RUNS: 
■THE::PR0GRA" ro PHDSUCE the plot. the appearance of the plot ^AY VARY ~ 
BETWEEN. THE DIFFERENT M AK ES 0 F T ERM I N AL S 5E C AU S E T HE D t S T AN CE SET WEEN: 
'PKINI. LINES IS NOT . AL'?! /\y:S S T ANO ARCi ■ FOR EXAMPLE* ON A " L'EE H I VE " 
:;TEHM:IN AL-.THE .CI KGLE AY tiE ELONGATED. THE TEnM INAL PP. I NT OUT OF SUCH ' 
. ft: iJSER I NTERACT ION FCLLO'fiS: 



"■ ' OLD PLOT 
READY 





LET, P=3. 14 159 




LET X«= Yb = i^ 




LET xy= Yy= . 


130 


LET X5=Y5=.i' 


^; 14// 


GOSUS 1/ . 


15i^ 


LEI R=4i? • .. : • 


■. 16 U 


LET N=2ii .. 


17i! 


iPKiNT "r"»"X"»"r;" : 


:18J 


..FOR T = 'J T'J 2*P STEP 2*P/N 


, 19 !# 


LET' .i'.= 5'i'*R«C0S<T ) 


■ 2 -J '4 


:LET. :Y=5k?+R*S IN(T ) 


'2V£ 


LET >-1=X 
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?2i? LET T1=r ■ 

, • 24tv p,< t'«T T« K« Y ■ 

:;. GOSUi; 2vJ ■ :■• 

; 26 1* NEXT T 

■V: -;27sf- fKlNT.. :■ 

: 2815 eOSUy 3-J ' ■ 
^,2:90 ENO' ■■ ' 

■ ' PLOT ; i)1/1V)/?'! ; i12:5 7 



T 

' ■ -■ 






ft 






y • 5 1 1 b 4 


: 8 8 • ui4 2 3 


: 62.36 B 7 


• </l ^ c 0 0 0 1 0 


dti . 3fak-7 ■ 


73.5 1 14 


i?«942477 


^ 73.51 14 


3 2. 36 7 


1.25*; 6 4 


•62. 36H7 ■ ' 


. 38. i!4 22 


1»5 7t?79 


: 5 . ii 4-1 1 




, 1.88495 ■ 


37.6 394 ■■ 


83.'j"423 


2.19911: 


26.4337 


3? .361* 7 


2.51 3?7 V 


; 17.6 394 


. .:73.51 15. 


2.H2743 


1 1.^5 73 




3.14 15 9 . 


-10 : ■ 




3.45575- 


1 1.9577 


■ 3 7 .6 3*^4^ 


3. 76991 


1 7. 6 392 


■ : 26.4887 


.4. H'i4i"7 : 


2b. 4335 


17.6394 


4.39623 : 


■37.fi,39 2 :. ::: 


■ 1,1. 95 78 


4.7123d 


■ - 4 ij i 9,99 h : 






. 6 2. 361*5 ^ 


11*9577 


■5. 34 V; 7 


■ l7 -3. 5^1:1:3 • ' ^ 


17 .6 39 2 


5.P5436 : 


■ 82.36^6 ■ ■^ 


2b. 4.^84: 


5.969t<2 : : 


83.M42 2 : 


::37.639 l: 


6.?8 318 : 


■ ■ :9l^\ .. ' : " . 


49.9998 





Y 
Y 

r 
1 

Y 

Y 
Y 
Y 
Y 

Y 
Y 
Y 

Y 
Y 
Y 

Y 

Y 
Y 
Y 
Y 



Ya= 
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1 • 1 Purpose . This document is meant to serve as a supplement to the ANSI 
specification of Fortran IV. It describes the differences between the existing 
Fortrans used at the five CONDUIT computer centers, and should be used as a 
guide for programmers in writing programs that are more easily transported 
between these five centers. It should be used in close conjunction with the 
ANSI standard specification of Fortran IV which Is cwailnble as X3 .9-1966 
from American National Staiidards Institute, Inc., 14 30 Broadway, New Yorki 
New York 10018. The sections in this document are numbered the same as 
those of the ANSI document. V/here ail five CONDUIT centers are in agreement 
with the ANSI document, the section in question does not appear here. Fortran 
features which are not ANSI standard are not discussed here and should be 
avoided in practice wherever possible . 



The five CONDUIT computer centers are: 



Machine 



Operating 
System 



Fortran 
level 



Dartmouth College 
University of Iowa 
NCECS (TUCC) 



Honeywell G635 



IBM 360/65 
IBM 370/165 



DTSS 



OS/360 



OS/360 
reh 2K6 



DTSS Fortran 



IBM Ibrtran IV 



IBM Fortran IV 



Oregon State University 

University of Texas 
(Austin) 



CDC 3300 

CDC 6400 
& CDC 6600 



OS-3 vers. 4.3 
UT2-D 



vers . 3.12 
rel. 60.2 



3.1 The ANSI document specifically states that it implies no collating 
sequence in the order in which it lists the characters used by Fortran. This can 
be Important since in the ASCII character code a numeric code can be checked 
agalns "A" and "Z'' to see if it is an alphabetic character, whereas in many BCD 
codes the alphabet is divided into three separate groups and would require a 
minimum of six checks. Because of these problems, any use of character codes 
should be avoided . If it necessary to use them^ their use should be described in 
comment lines in the program. Their use should not involve literal numerics in 
the program code, but should be mediated through hollerith constants assigned 
to variables with mnemonic names (DATA PLUS/lH^/) or through the use of a 
character code lookup table if the use relies on the collating sequence of a 
particular code. If a lookup table is used, it would be replaced at each center 
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and should bo documented as such within the program with a description of the 
code that it should map into. The program should require no other changes to 
make use of the new table. 

3.2-3.4 Any systems using free format Fortran in which it is not necessary 
to conform to column numbers on a line should have some means of editing their 
programs into formatted form adhering to the correct column numbers for the 
major parts of the line: 1-5 for statement numbers, 6 for the continuation 
character, and 7-72 for the statement. Programs should be edited into formatted 
form before export. 

4.2.5 Some implementations of Fortran do not have logical data types. 
Because of this limitation, use of logical variables should be avoided and 
logical expressions should be used only in logical IF statements. 

4 #2. 6 Hollerith data should be avoided since It is more machine 
dependent than any other data type and it has no standard implementation. If 
such data is necessary, it should be used sparingly and its purpose described 
within the program. See also section 3.1 of this document . 

5.1.1.5 See section 4.2.5 of this document concerning logical data type s . 

5.1.1.6 See section 4.2.6 of this document concerning hollerith data types . 

6.1 Some systems do not allow mixed mode arithmetic and the results on 
those that do may not be the same. Programmers should avoid mixing variable 
types in an expression except for those cases specified in the ANSI standard 

in lines 33-48 of this section. The permitted exceptions are: 

a. exponentiation of any type by an integer primary. 

b. exponentiation of real or double precision by either a real 
or a double precision primary. 

c. real elements mixed in either double precision or complex 
expres sions . 

6.2 Relational expressions should be used only in logical IF statements 
and not in assignment statements. See also section 4.2.5 of this document. 

6.3 Logical expressions should be used only in logical IF statements 
and not in assignm.ent statements. Since some systems do not allow the use 
of parenthesis to force the order of evaluation of logical expressions, such 
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expressions should be kept simple. See also section 4.2.5 of this document. 



6*4 Take note of lines 3-8 in this section of the ANSI standard concerning 
evaluation of expressions containing functions. Side effects of the function on 
other items in the expression are not allowed . 

7, 1 ,1.2 Logical assignment statements should not be used. See also 
section 4.2.5 of this dociment. 

7 • 1.1. 3 The ASSIGN statement should not be used since some implementa- 
tions do not have it. 

7*1.2.1.2 The assigned GOTO should not be used since some implementa- 
tions do not have it. 

7.1.2.1.3 The value of a variable u sed in a computed GOTO should be 
checked and an error message printed when it Is out of range. The action taken 
by various implementations in such cases is different and cannot be relied upon 
when a program is moved. 

7.1.2.7.1 When a STOP statement is executed, some Implementations 
accept an argument to the statement and print it out as in indication of which 
STOP has been executed. Since this is not used by all implementations it should 
be avoided. 

7.1.2.7.2 The PAUSE statement should not be used since many large 
systems do not allow it. 

7.1.2.8.1 If the initial parameter of a DO loop i s greater than the terminal 
parameter the results cannot be guaranteed between different systems. This 
condition should be checked by the program before entering a DO loop. 

7.1.2.8.2 Extended ranges of DO loops should not bo used. Also note 
that ANSI specifications do not allow the control variable or loop parameters 
to be altered within a DO loop. 

7,1.3 Any unit numbers in READ or WRITE statements should be specified 
as variables whose values are assigned and commented at the beginning of 
the program. 

7.1.3.4 The character " + " as a carriage control in a FORMAT statement 
causes "no advance" according to ANSI standard. No advance is taken as 
meaning that the record overprints the previous record; in other words the 
print is preceded by a carriage return but no line feed. 
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7.2,1.1.1 Any use which depends on the internal representation of arrays 
shovld be avoided. Implementation differences can cause problems if COMMON 
or EQUIVALENCE Is used with arrays of different sizes or different numbers of 
dimensions • 

7,2AA.2 Adjustable dimensions in subroutines should be avoided since 
some systems do not allow them. 

7.2 , 1 ,3 • 1 , 1 Since not all machines use the same amount of storage for 
various data typos, procjramming should be independent of such internal repre- 
sentations, COMMON statem.ents indifferent program units should contain 
identical data types, for example, and not use a real variable to take the space 

in COMMON used elsewhere by an integer variable, * 

7.2,1.4 EQUIVALKNCE sho\ild be avoided in the interest of keeping a 
program readable and its effects clear, 

7.2.1,6 See section 4,2*5 regarding logical variables, 

7,2.2 Some implementations will repeat a DATA field until an array is 
filled. This convention should not be used. There should be a one ' ne 
correspondence between variable elements and data elements, 

7.2.3*1 (1) It was agreed not to use G, D, or L conversion codes m 
FORMAT statements because some implementations do not have them. The 
restriction on D may be hard to stick to, (2) Scale factors should not be 
used since some implementations do not have them, 

7.2.3-5 Scale factors should not be used. 

Table 3 and 4. Some systems do not have all the functions in double 
precision and complex* If these must be used there should be a list in 
comment lines at the top of the program of those which are used, 

8.3 Random 't.mber functions are used at all the CONDUIT centers for 
various modeling and simulation applications , These routines are typically 
machine dependent and cause much difficulty since test runs cannot be 
verified when the program is implemented at another center. To solve this 
problem, each center has a test deck of random numbers and a substitute 
subroutine to pick the next number from the deck (or a file containing it). 
All sample runs should be made v/ith the table lookup routine in the place of 

the random number generator. A listing and deck of the random numbers used should 
be Included v/ith the program when it is sent to another center. When tae 
program has been implemented, and the results verified using a table lookup 
routine, the random number generator available at that center can be substituted. 
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It Is assumed that the random numbers are evenly distributed between 0 and 1. 

9.1,2 Some systems require a PROGRAM statement at the beginning of a 
program body. This statement may also set up piles for the program. This is 
not ANSI standard and should have comments in the pro^jram describing what files 
are being set up for what purposes and the logical unit numbers that they v/ill 
have . 

10.2.6 In some implementations DATA statements in a subroutine renew 
their effect every time the subroutine is called, while other variables in the 
subroutine cannot bo guaranteed across calls to that subroutine. In other 
Implementations the variables retain their values across calls ro the subroutine. 
Since differences in overlay techniques affect the v/ay tnis works on different 
systems, variables should be initialized at the beginning of subroutines and 
not be expected to retain their values between calls. Variables which appear in 
DATA statements in subroutines should not be altered in those subroutines. 

11. Items not mentioned in ANSI standard or in this docum.ent should be 
avoided. For example, ENCODE and DECODE, BUFFERIN and BUFFEROUT, 
LIBRARY, or CHAIN. Where they cannot be avoi."^ed, they should be cominented 
within the program so that the programmer receiving it will know what is intended 
and be able to replace the code with something that v/ill work at his center. 
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Editorial Aids for Im p orting and Exporting Fortran Programs 



on DTSS 



Introduction 

The average academic computer center is batch processing, card oriented, 
and uses mostly Fortran. Dartmouth is time-sharing, terminal oriented, and 
uses mostly Basic, Because of these differences, there are problems which 
invariably arise in exchanging computer materials with other centers and which 
can be alleviated to some degree thro^igh the use of text processing computer 
programs. To this end, a small collection of such programs have been developed 
by Project CONDUIT. These programs are written in D^^rtmouth Basic 5th Edition 
and are in the CONDUIT sublibrary CONLIB***, They are: 



Each of these programs will be described in detail below. 

Exporting Fortran programs 

On a card oriented system, Fortran programs are written in what will be 
referred to in this paper as card image format. That is, rather than having 
lines of the program free format as on DTSS, there is a strict adherence to the 
columns on the card. Columns 1-5 contain the statement number, column 6 
contains the continuation character, columns 7-72 contain the Fortran statement, 
and columns 73-80 are reserved for sequencing numbers. If a "C" is punched in 
column 1 then that card (line) is a comment. A card image file does not have 
line numbers in front of each line. 

FREECARD: This program converts a free format DTSS Fortran program 
(* for comment, and & for continuation) to a card image Fortran program. No 
changes are made in program content: it is simply reformatted to adhere to the 
correct column numbers. FREECARD works on the user's current file and the 
output becomes the user's new current file after the execution is successfully 
completed. To use FREECARD, type: 



Where program-name is the name of the file to be edited , When the computer 
responds READY, type: 



FREECARD 

LINELEN 

SEQUENCE 



CARDFREE 
DESEQ 
FORMATS 
FRTAN 

COMMENTS 



OLD 



prog ram-name 



EXECUTE CONLIB***:FREECARD 
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When the computer again responds READY, the resulting lUo may be LfSTed, 
REPIACEd, FUlNAMKd, and SAVEd , or whatever is desired. It should be a 
standard precaution after using any editing program to spot check the results 
before typing REPLACE in order to prevent any needless loss of programs. 



LINELEN: When sending any file or program to another system, the length 
of the lines should be checked. A line that is too long can cause a record 
length error when putting the file on tape or cards. Also, most Fortran compilers 
on card oriented systems do not look past column 72, so anything that is beyond 
that column will be lost and may result in a faulty program. LINELEN is a 
program which checks line lengths in the user's current file. To use it, typo: 

EXECUTE C0NLI3***:LINELEN 

The program will ask for a maximum line length. Normally a maximum length of 
72 should be entered. The user's current file will then be searched, and any 
lines longer than the specified maximum will be printed out. The user's current 
file will not be altered. Any offending lines in the program may then be altered 
by the user. 

SEQUENCE: Some card oriented systems prefer to receive programs with 
sequencing numbers in columns 73-80. These numbers make it easier to spot 
check and assure that the program was received intact. SEQUENCE works on 
the user*s current file. It checks line lengths against a maximum of 72 and 
adds sequencing numbers in columns 73-80. To use SEQUENCE, type: 

EXECUTE CONLIB***:SEQUENCE 

When the editing is complete, the resulting file will become the user's 
new current file and may be LISTed, REPLACEd, or whatever. 



Imj>ortinq Fortran Programs 

There are two ways to get an imported Fortran program running on DTSS, 
First, since Dartmouth is developing a good ANSI standard Fortran, running the 
Imported Fortran program in Fortran is becoming a viable alternative. The second 
alternative, and that which has been used in the past, is to translate the Fortran 
program into Basic. There are progiams available to aid the user in both 
alternative s . 
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CARDFREK: This program reformats a card image Fortran program into a 
free format, line numbered Fortran program suitable for use with DISS F'ortran. 
It works on the user's current file, and fater successful completion the output 
file becomes the user's new current file. To use CARDFREE, type: 

EXECUTE CONLIB***:CARDFREE 

This will only reformat the program and will not change any of the content. To 
find out what programming changes have to be made to get the program running, 
the user v/ill have to rely on prc^jram documentation and error messages from 
DISS Fortran. Working Paper '7\greeable Fortran", contains notes on language 
differences between the five CONDUIT centers and m.ay be helpful. 

DESEQ: This program will remove sequencing numbers in columns 73-80 
and trailing spaces from a card image Fortran program. This usually saves 50% 
or more of the file storage required to keep such a program. DESEQ v/orks on the 
user's current file, and upon successful completion the output becomes the 
user's new current file. To use, type: 

EXECUTE C0NLI8***:DESEQ 

When the computer responds READY, the result may be LISTed, REPIACEd, or 
whatever. 

FORMATS: One annoying characteristic of Fortran Is that the FORMAT used 
in conjunction with a PRINT or WRITE isn't always in the same place in the pro-- 
gram* Depending on the style of the person who wrote the program, the FORMAT 
statements could be either grouped or scattered anywhere in the program. 
FORMATS will search through a card image Fortran program, locate all the 
FORMAT statements, sort them according to the statement numbers, and group 
them immediately before the END statement of the program. If there is more 
statements for each one will be placed before the END statement of that particu- 
lar program unit. With the FORMAT statements sorted and grouped in this manner, 
a particular one can be located Vvrithout any trouble. To use FORMAT, the card 
Image Fortran program to be edited should be the user's current file. Then type: 

EXECUTE CONLIB***:rORMATS 

Upon successful completion the results of the editing will become the user's nev/ 
current file and may be LISTed, REPIACEd, or whatever* 

FTRAN: If a decision is made to run an imported Fortran program in Basic, 
this program makes the task much easier. FTRAN takes a*card image Fortran 
program and produces an output file in which most of the program has been 
translated into Dartmouth Basic. To use FTRAN, type: 
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.CD CONUB***:FTRAN.RUN 



It Will then ask for the names of an input file and an output file . The names of 
ti.e files should be typed on the same lino separated by a comma. If one of 
the files has a password then the name and password can be entered using 
quotation marks: 

"Filename , password", Filename 2 

where the appropriate file names and passwords are used. If the run exceeds the 
user's run time limit, FTRAN can be run in Background by writing a Background 
program as follows: 



100 RUN 

110 OLD CONLIB***:FTRAN 
120 LINPUT filename, filename 
130 OUTPUT errorfile 
140 END 

where the two filenames in line 120 are the names of the input and output files, 
and ''errorfile" in line 130 is the name of any empty file in the user's catalog 
into which the Background run and any error messages will be v/ritten. To submit 
this Background job, SAVE it and type: 

BACK 

If the Background program is correctly written the computer will respond "***JOB 
ACCEPTED" . The user can then do something else until the job is completed. 
See TM053 , "Introduction to Background", for any questions on the use of Back- 
ground . 

There are five steps that should be caken in using FTRAN that will make 
the job considerably easier. 

1. Once a clean copy of the card im.age Fortran program is available, 
some preliminary editing m^ay be needed. The programs DESEQ and 
FORMATS can be used for this purpose. The program should also be 
checked to m.ake sure that the correct character code was used. For 
example, open and close parenthesis may appear as percent and dollar 
signs if the wrong character set is specified for reading in a card deck. 

2. Run FTRAN giving it the input and output file to work with. 

3. Get a clean listing of the input and output files. To make the fourth 
step easier, the card image Fortran program used as input should have 
line numbers put on it starting at 1000 and going in increments of 100. 
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To do this, call up the program and typo: 

EDIT SEQUENCE 1000,100 

When the computer responds READY, REPIACE the program. Also, the 
Basic program in the output file needs to be sorted. To do this, call up 
the program and typo: 

SORT 

When the computer responds READY, the program can be REPIACEd* 
When this has been done, a Background program can be written to PRINT 
the input and output files on the printer. 

4. Now set the two printouts side by side and correct all lines that have 
been commented by FTRAN» The line numbers on the Fortran program 
should correspond exactly with the line numbers in the Basic program 

if step 3 has been followed correctly. Problems that will be encountered 
and how to handle them will be discussed in detail below. 

5. When all the corrections have been made, RUN the Basic program. 
Usually there v/ill be some additional corrections to bo m.ade, and some- 
times there will be some rather difficult problems encountered. See the 
discussion of these problems below. When the program seems to run 
successfully, thero should be some test runs with the program that can 
be used to verify the correctness of the translated version. Tiy out the 
test runs and compare the results with those obtained by the original 
computing center. Always keep the line numbered listing of the Fortran 
program handy so that the Basic translation can be checked, and do 

noi EDIT RESEQUENCE the Basic program until the results have been 
verified and the translation is considered final. At that time the table 
of variable names can be EDIT DELETED, a header of comments can be 
added to describe the origin and purpose of the program and who trans- 
lated it, and the program' can be EDIT RESEQUENCEd. 

There are several problems that m.ay be encountered in steps 4 and 5. Lines that 
were not translated and which may cause problems get flagged with a comment by 
FTR/\N. These error comments fall into three categories: 

2. CHECK THIS 

3 . UNDEFINED ARRAY OR FUNCTION NAMF 
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Here Is an example of what a section of program might look like in the 
Fortran </ersion and in the Basic v'erslon: 



FORTRAN 

1000 IF (X) 350,350,371 
1100 216 Y=X 
1200 GO TO 371 



BASIC 

1000 IF XI <= 0 THEN 2100 

1001 GOTO 2300 

1100 LET Y1=X1 
1200 GO TO 2300 



2100 350 CONTINUE 
2200 ASSIGN 350 TO Z 
2300 371 CONT^^^UE 
2400 PRINT 100, X,Y 



2100 NEXT 14 

2200 ASSIGN 350 TO Z 'W^IAT? ? ? 
2300 NEXT J4 

2400 PRINT 100,X1,Y1 CHECK THIS 



There are a couple of things to notice in this example. 

1. There Is a direct correspondence between line numbers. Line 1000 
took two lines in Basic, but they were numbered 1000 and 1001 so that 
line 1100 in the Fortran program still becomes 1100 In the Basic program. 



2. FTr(AN added WHAT? ?? onto line 22 00. This means that it didn't 
translate line 2200 at all but copied it directly from the Fortran program. 
This line will have to be translated by hand. 

3. Line 2400 has the comment CHECK THIS. Lines flagged with this 
comment have had the variable names translated. The line will have 
to be retyped to incorporate FORMAT statement 100, but the variables 
do not need to be looked up in the variable table. The lines with 
"WHAT???" added to them do need the variables translated, and for 
this purpose a talkie of all the variable translations is added to the 
beginning of the Basic program. 

The error message "UNDEFINED ARRAY OR FUNCTION NAME" means that a 
name was encountered followed by an open parenthesis and the name was not 
declared and vjas not a standard supplied function. These errors might result 
from program fragmentation when it was imported, non-.nandard fsupplied 
functions, or a user defined function. It should be noted that in Fortran all 
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lists and arrays must be declarecL If a program statement appears to be 
assigning some value to an clement of an undefined list, that statement Is 
probably a statement function. It should be translated into Basic as follows: 

FORTRAN: NAME (X,Y) ^ S1N(X)^Y*^2 

BASIC: DEF FNN{X,Y) ^ SIN(X)^f2 

Then every occurrence of "NAME(" in the program should be replaced by ''FNN("* 
If this replacement is done with the te>ct editor (as it should be), the program 
will bo left with error comments on lines that have already been corrected* See 
the description of the program COMMENTS below for an easy way to get rid of 
specific comments. 

Some supplied functions are standard but do not have any corresponding 
function in Basic. These can be translated using function definitions. A couple 
of examples that n^ay cuase problems are; 

FORTRAN BASIC 

SIGN (X,Y) 100 DEF FNS (X,Y) 

no LET FNS-ABS(X) 
120 IF Y< - 0 TflEN 140 
130 LET FNS - -FNS 
140 FNEND 

L0G10(X) 100 DEF FNL(X) - LOG{X)/LOG(10) 

The first example is a source of problems because Basic defines the 
sign of a number (SGN) as having a value of -1,0, or -^ l, whereas in Fortran 
the 0 is grouped with the -fl. The second example requires a little thought 
and is not terribly accurate. However, it is accurate enough for most uses. 

There are a few other specific things that can cause problems. DATA 
statements are implemented differently at different centers. In DTSS Fortran the 
number of items of data must be the same as the number of variables. That is, 
if a list is dimensioned at 25, it must have 25 elements of data associated with 
it In a DATA statement. In some Fortrans the data field is repeated just like 
a FORMAT statement. If a program contains two lines 

REAL NAME (2,2 5) 
DATA NAME /I ,2/ 

then the two item field is repeated until the entire array is filled. 
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String or character variables and caracter codes are different everyv/hore. 
If an imported Fortran program uses these types of variables a lot, then that 
program should be documented well enough to describe exactly v/hat is being 
done. Code containing these variables has to be translated by hand. 

The one problem which causes the most trouble is the use of COMMON 
and EQUIVALENCE with subroutines and function subroutines. These are 
flagged by FTR>\N and need careful attention. Variables in COMMON should 
be added to the variable lists on the Basic SUB and CALL statements in the 
same order as they appear in COMMON. labeled COMMON should be 
separated bv name and each block treated independently. The following 
example demonstrates this: 



FORTRAN 

COMMON /A/Vl, V2 
COMMON /B/V3, V4 , V5 
CALL SUPld J,K,) 
END 

SUBROUTINE SUBl (L, M , N) 
COMMON /B/V1,V2,V3 
COMMON /A/V4 ,V5 
END 



BASIC 



CALL "SUBr':IJ,K,Vl ,V2,V3,V4,V5 



END 



SUB "SUBr':L,M,N,V4 ,V5,V1,V2,V3 



SUBEND 



Special care should be taken in dealing with lists and arrays in COMMON 
when they are not dimensioned the same. ANSI standard and most im.plementation 
of Fortrans specify that subscripted variables are stored in memory in such an 
order that the first subscript varies most rapidly. Using this as a guide, messy 
COMMONS can be unravelled. 

Equivalences usually involve sim.ple substitution of variable names with 
the text editor. However, there is sometimes a reason for using them such as 
character and integer variables to do manipulations of character codes. Such 
uses should be docum.ented within the program. 

The most difficult case to deal v/ith is COMMON and EQUT/ALENCE in 
a subroutine function. Such a function presents probleras because in Fortran 
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the variables not in the arqurnent list are local to the function, whereas in Basic 
the function has to be moved into the nuiin program and the variables can affect 
variables of the same name in the main program, [f the function is passed to a 
subprogram, variables not on the argument list v/ill point teck to the variables 
in the main programi. Language difforencos in a messy ^utuation like this can 
cause incredible problom^s. If too much difficulty is encountered getting 
correct results the easiest solution is to change the function to a liasic subprogram 
and alter the function calls: 



FORTRAN 

COMMON /A/V1//2 

RSLT- FUNG (X9 , ALT) *C OS {RTl ) 

END 

FUNCTION FUNC(X,Y) 
COMMON /A/A5,A6 
FUNC - A5*A6^X**COS(Y) 
END 



EiASIC 

CALL "FUNC":Xg,ALT,Vl,V2,Q9 
LET RSLT-09*C0S{RT1) 

END 

SUB "FUNC":X,Y,A5,A6,Q9 

LET Q9 =^ A5*A64-XtCOS(Y) 
SUBEND 



Of course, all the variable names v;ould be changed in the liasic version. 
The important point is that the COMMON variables are added to the call list 
and can be passed appropriate values or variables from subprograms. Also, 
variables which were local in the Fortran version rem.ain local in the Basic 
version, and an extra variable has been added to take the place of the function 
value. Any expressions referring to the function have to be broken into 
several lines to accomiodate the call statements. If the function is passed 
to a subprogram, then a variable can be passed that indicates the correct 
subprogram to call and an ON GO TO can be used. This can get messy, but 
it is a hazard of using complex language features* Such features :^hould be 
used with discretion when it is expected that a program may be exchanged with 
other computer centers. 



COMMENT^; After correction the output file from FTR>\N using the text 
editor, a number of flag com.raents may still be on the program. COMMENTS 
provides a quick and easy mieans of rem.oving them. It works on the user's 
current file and removes comments from specified lines. The output becomes 
the user's new current file after a su::ce3sful run. To use it, Cc.ll up the file 
to be edited and type: 
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EXECUrE CONLrB***:COMMi:NTS 



A question mark will be printed on the terminal asklnq for input. Tho usor 
should type in a list oi line numbers in ascending orcicr. COMMENTS will 
then print another question mark rind the user may enter more line num!)ers 
continuing in asconding order from the end of the last list. When there are 
no more lines to be specified, a simple carriage return in response to the 
question mark will terminate the program. The user's new current file will 
have the comments removed from the specified lines. It is usually .safer to 
use the text editor and COMMENTS to clean up large groups of arithmetic 
formulas, because retyping often results in typographical errors which can 
be difficult to locate when the program does nov test properly. 
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The Export System 



Until recently each request for a set of programs from the 
computation center has been a special event. Special events cost 
people lots o£ wasted time and effort. 

The Export system is a series of programs designed to store 
export versions of programs on magnetic tape and recover them in 
a form suitable for mailing to a customer. 

Storing the programs is a job of the program librarian. 
Thirty programs can be done in about an hour. 

Recovering the programs is a job of the corresponding 
secretary. He can recover a set and do the accompanying paper- 
work in under ten minutes. The response should be in the mail 
to the customer within 24 hours. 

Storing a Procjram 

Prepared programs and Q-files are approved by the Manager of 
Dar tmouth-CONDUIT and forwarded to the Program Librarian who: 

1. Writes all files on the storacje tape, 

2. Registers on-line for each file: 

a. Position on the storage tape 

b . Name 

c. Length in words 

d. Length in blocks 

e. Length in lines 

3. Runs REPOSIT and addresses the sot by subject, author, 
program name, and for each program, records 

a. Name 

b. Name of storage tape 

c. Position on storage tape 

d. L for list or LT for list and tape output 

* 

e. Length in characters 

f. Length in lines 

4. Informs the COMBIB editor of a new set for sale. 
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E xporting a Program 

When a corresponding secretary receives an order for a 
program set, he (or she): 

!• Makes sure payment is enclosed (or returns letter 
with a note requesting pre-payment) . 

2. Runs EXPORT for the appropriate sets. 

3. Starts EXP-BACK and buys a new magnetic tape from 
the operator for the program to write on. 

4. Writes a cover letter, prepares a tape sheet. 

5. Mails 

a. Cover letter 

b. Tape sheet 

c. Magnetic tape 

d. Listing 

People to Contact 

See the Manager, the Chief Programmer or the Program 
Librarian for a detailed run through of the system. 
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Working Paper #6 



How COMBID Works 
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A consortium of regional networks at 
Oregon Slalo University. North Carolina Educational Computing Sorvlco, 
Dartmouth College, and the Universities of lowa and Texas (Austin), 



How COMB IB Works 
John M. Nevison 

May 197 4 



Dartmouth-CONDUIT 
Working Paper §6 

I 
) 

* DRAI^T COPY - Not to be reproduced without the written permission * 

* of the author. * 
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COMBIB was designed to answer the teacher's question, 
"What does CONDUIT have for me?" It the interrogation is at a 
teletype terminal; the answer will take no more than ten minutes 
and will be in writing that he may take with him. The answer 
will be taylored by the teacher to his own interests. 

A system that so serves the teacher can also provide the 
service organization itself with an up-to-date record of the 
status of prograjii sots associated with books and booklets in 
its bibliography. 

The bibliography arranges r* cerences by subject. To each 
reference are appended details o*, its recent history, "Commentary"; 
who has various versions of the computer programs, "Languages; 
and details about the programs, "Programs." 

A reference in COMBIB looks like the illustration in the 
Appendix. It is a book or booklet describing the use of a 
computing idea in regular courses (not in Computer Science) in 
college or graduate school. It contains: 

1. The author, and reference 

2. The cost and how to order 

3. Who recommended it 

4. A list of appropriate details. 



Additions and Corrections 

All changes to COMBIB are made by the editor. He (or she) adds 
new entries ; edits existing entries, and deletes old entries. 
He obtains his information from a variety of sources , but 

checks each one with a qualified reviewer before entering it in 
COMBIB. As a further control, he returns a Scimple of the 

listing to the individual who recommended the book and to the 
book's author and publisher. 

Every paragraph in the Commentary on the book bears the 
initials of its author and date of entry. The first paragraph 
can be used as the short description included in an annotated 
bibliography . 

Major alterations of a reference are sent to the author 
and to other concerned individuals. 

In June of 1975 there will be a complete house cleaning of 
COMBIB. This will be repeated every second year. 
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COMB IB Services 



In addiLion to answering tho immediate questions of a 
teacher at a teletypG, COMBID may be used in other fashions. 
The editor can release a catalocj of the complete contents of 
COMBIB. Such a catalog is no t available to the general public 
at this time* 

The editor can also release an annotated bibliography of 
the entire contents of COMBIB or of a selected discipline. These 
are available from the editor for a fee, COMBIB will also collect 
statistics on its use which the editor can monitor. 



To Try' COMBIB 



If you wish to try COMBIB from your terminal (teletype) : 

1- Call 603-646-5171 10 char/sec 

-5141 15-^30 char/sec 

2. Type the user nmnber R13999 and push the carriage 
return key 

3. Type the password CON 

4. Ask for an OLD program 

5* Type the old program name (sixteen characters long) 

CONLIB*** sCOMBIB 
6, When the machine is ready, type RUN and carriage return. 
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Tijtlc_: Survey Sampling 
Approacl) 



in the [inv ironinent a 1 Sciences: a Computer 



Au t h 0 r s ; James W Barrett 

Department of ['ores try 
University of Xew Hampshire 



Mary Nutt 
Department of 
University of 



Zoo logy 

Xew Hampshire 



Abs t rac t ; Computer programs are used to approach the theory, 

planning, and application of sampling in the environmental 
sciences. In addition to five basic methods Csimi)le random 
sampling, systematic sampling, stratified sampling, 
regression estimation, and cluster sampling), special 
techniques are {^resented for use in forestry and field 
zoology. The exercises cover a wide range of environmental 
issues and wi^erever practical the data are taken from 
current scientific research,, The text is written for 
college undergra^iuates in the natural sciences and assumes 
little or no experience witli statistics. The programs are 
in BASIC and reciuire little or no programming abilityo 

In survey planning, the computer is used to investigate the 
interaction of precision and cost. For each sampling 
method, programs calculate the required number of samples 
and estimated cost at specified levels of precision and 
confidence. For each sampling method, programs compute 
means, totals, and confidence intervals as well as 
variances, standard errors and other details o 

The book consists of ten chapters: Introduction, 
Populations and Samples, Sampling Theory, Simple Random 
Sampling, Systematic Sampling, Stratified Sampling, 
Regression hstimation, Cluster Sampling, Forestry, and 
Field Zoology. Programs are listed at the end of 
appropriate chapters and exercises are provided which rely 
heavily on the use of these jn'ograms. 

Aj>j2roxin\a^t£ length : 300 pages 

16 programs written in BASIC are available with tliis 
package • 



Status 



Fi rs t 

lOo 



draft of text complete with the exception of Chapter 
Anticipated completion date is early summer 19 74. 
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Abstracts 



Ti t lo; Cor,ni. Live Psycho Ior/: a Computer-Oriented Laboratory Majuial 

AuUior: William I.. Hew ley 

^ Department of Psychology 
Lawrence University 

Abs^t^act : This book provides a laboratory introduction to cognitive 
psychology. The material is prescjited by means ov'six 
experiments, each of which is run on a time-sl:ared computer 
system using the BASIC language and a teletype terminal as 
the input/output devicco In each experiment, the computer* 
presents a task to the student and to a simulatio!i oi' a 
model of human information processing relevant to the task. 
The student is asked to compare his performance with that 
of the model and to compare what he thinks he did in the 
task with wluit the model says he did. The simulations are 
designed so that features of the task and the model can be 
changed by the student, allowing him to run his own 
experiments on the model or on other humans. Questions are 
asked at tlie end of each experiment which lead the student 
to conduct such exper in\ent s « 

The six experiments were chosen to cover the range of cog- 
nitive activity represented in the current general concep- 
tion of the human Information-processing system (e.g., 
Atkinson Shiffrin, 1968; Norman and Rumolhart, 1970) ^ 

Experiment U Pattern Recognition 

Task : vi sua 1 s earcli 
Model: pandemonium (Self ridge, 1959) 

Short-Term Memory 
Task : Cent inuous Memory 

Model: buffer model (Atkinson Shiffrin, 1968) 
hong-Term Memory 

Task : Pa ired-assoc ia te learning 
Model: Discrimination net (llintsman, 1968) 

Concept Learning 

Task: Blank trials task of Levine (1966) 
Model: Several--sampl ing with replacement, local 
consistency, consistency cJieck, focusing. 

Decis ion-Making 
Task: Two-person game 

'Model: A combination of the social laotives of Messick 
and McClintock (1968) and tlie linear operator 
model of Rapoport and Chammah (1965) 



Bxper inent 2 o 



Kxper iment 3o 



Rxperiment 4o 



Experiment 5 
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lixperimcnt 6, Problem Solving 

Task: Missionary and cannilK'ils problem 
Model: The Gci\cral Problem Solver (lirust Newell, 
1960) , 



The prcserUation of each experiment includes a brief abstract, a 
description of procedure, a description of tfie model, a set of study 
questions desii',ncd to encourage critical evaluation oi' the model and 
independent exiicr i ment a t ion , and a jieneral discussion which briefly 
describes alternavive models and suggests further readingo In 
additioi\ to the six experiments, the book contains an Introduction « 
describing the relation of each experiment to the general information- 
processing model, ai\d two appendices, one dealing with a suggested 
format for lab reports and the other with the minimum chi square 
procedure for goodness of fit. 

An instructor's manual contains program listings and documentation 
and discusses material not included in the student book which the 
instructor may wish to use as background for the experiments. 

Length : Student manual--! 02 pages 

Instructor's maniial--96 images 

7 programs in BASIC are available with this package. 



Status : Student manua 1- - !• inal draft completed. 

Instructor's manual-- I^inal draft completed. AVAlLABLh FOR 
CLASSROOM USUI 
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LL^JiL' ''^^^^ Calculus of Populatior\ (tentative) 

Authors ; Kenneth I\ Bogart f, Michael R. Vitale 

Mathematics L)ei)artment Mathematics Department 

Dartmouth ColU^^^o Skidmore College 

Abs trac t ; An informal, appl i ca t ions -or i ented introduction to the 
theor)' of calculuso The computer's role in helpijig 
students to understand concepts and find solutions to 
problems is emphasised. The text is designed for 
supplemejitary use in an elementary functions course, or as 
an introduction to a more rigorous course in calculus. It 
assumes a background of high school algebra (laws of 
exponents, rational numbers, graphing, absolute value, 
sets) and exposure to elementary programming in HASIC or 
rel a ted 1 anguages , 

Chapter 1 examines the growth characteristics of a 
population of paramecia, using tlus sample as a vehicle for 
developing methods of describing and predicting growth and 
rates of growth. Chapter 2 discusses the concept of a 
derivative in greater detail, demonstrating how to find the 
derivative of a variety of function types,. In addition it 
discusses the concept of area and develops methods for 
finding the area of various regions of the plane, Cl.apter 
3 considers the properties of the derivative in still more 
detail and establishes a connection between the derivative 
and the integral, demonstrating techni(iues for finding 
integralso Chapter 4 synthesizes the content of the 
previous chapters by applying the results to the more 
complex situation of two species in a closed environment, 
Ilmphasis throtigtiout is on ma tiiemat ica 1 representation of 
the propert ies of population, using this development as a 
rationale for the study of calculuso Exercises follow each 
chapter, many requiring the use of a computer. Programs in 
BASIC are included as part of the text. 

App roximat e leiigth ; 180 pages 

36 programs written in BASIC are available witli this package. 

Status : Final draft complete. 

AVAILAULb FOR CLASSROOM VSlll 
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Title! An Introduction to Finvironmcntal Measurement and its 
Descriptive Analysis by Cominiter 



Author : George W Hstabrook 
Department of Botany 
University of Michigan (Ann Arbor) 



Abstract : Designed to serve as a specific guide to methodology in the 
investigation of environmental variation. The exposition 
is based on the contention that metliod is learned througli 
its practice, and assumes active involvement on the part of 
the student in the study of some aspect(s) of environmental 
variation. Three si^ecific data analysis techniques are 
discussed to exemplify the role of data analysis in 
scientific methodology. They serve the following 
purposes : 

1) to quantify the similarity of pairs of objects in a 
study described with nominal or ordinal measurements, 
leading to discovery of the hierarchical classification 
involved ; 

2) to quantify the extent to which one nominal variable 
can be predicted from the knowledge of anotlier, and to 
describe the nature of the correspondence wliich makes 
this prediction possible; 

3) to represent spatially in a few dimensions the objects 
in a study described by interval or ratio variables, 
and to describe the relationship among the variables 
which makes sucli a representation possible. 

The specific techniques were selected because thev offer 
distinct a])proaches appropriate for different kinds of 
measurement analogies; because their methodology is 
sufficiently straightforward and simple to be accessible to 
students without sophisticated mathematical (backgrounds; 
because thev are general and offer wide potential 
applicability in environmental studies; and because they 
lend themselves to computer programs whicli can be used by 
students to exploit the techniques = 

Significant use is made of the computer in analyzing study 
objects according to these techniques, and instruction i-* 
provided in tho intelligent use of the programs written for 
the booko Various study- related tasks are* also assigned 
the student as he progresses through the text. 
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Chapters: How to Use tliis Book; Measurement of the 
Hnvironment; Ropresentat ioi^ of Data; Similaritv Amoiui 
Objects; Stochastic Dopeiulence of Nominal Characters'; 
Hierarchical Classification of Objects; Spatial 
Representat ioa of (H^iects in a Stiuly^ Appendices include 
an extensive bib 1 ioj:ra5>[\y of pertinent literature and 
discussion of how to use the computer pro^^,rams = 

Ap proxi mr.te length; Text 85 pages in single-spaced draft; will be 

changed to double space in next version 

Bibl iogrnph)' 10 pages 
Other appendices — 4b pa,^es 



Stat us ; Final draft complete and beinj^ used by author in regular 
course 

AVAILAHLi; FOR CLASSROOM USFJ 
Three programs written in FORTRAN accompany the text. 
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Title ; Physics of Hnergy ond Environment 



Aut hor: Allan Ro Ivvans 

Department of Physics 

University of California at Irvine 

(currently: Societal Analysis Dept», CM Research I.abs) 



Abstract : An outgrowth of a course entitled "Physics of the 

Hnvironment" taught by the author for two years, these 
computer-oriented materials have been developed to discuss 
the phys ics of envi ronmcntal problems , Hmphasis is on 
physical principles , model formulation, and quant i tat ive 
solutions, with the conputer used in an interactive node 
for instruction and calculation^, Hsseutial introductory 
material studies the tools of quantitative reasoning, 
including concepts of rates of change and functional 
dependenc ies • 

This material is intended for use in courses dealing 
expressly with environmental problems, or as supplementary 
material in traditional physics courses for non-majors* 
The following sections are included: 



Part I. (No title yet) 

A* Trends, Change, and the Scale of Problems 

^electrical energy consumption 

^simple and compound growth 

^compound growth of population 
B, Growth and Consumption in the Environment 

^electrical energy consumption 

*UpSo population growth in present century 

*motor vehicle population 

*total energy consumption 

^electrical energy and total energy consumption 
Co The Problem of Human Population 

*growth of populations-characteristics 
*growth of population- -models 

Part Ho The Energy Balance of the Earth 

Ao The Scale of Human Intervention 
* energy consumption 
^alteration of the eartK^s surface 
*air pollution 
^global temperature increase 
*climatic changes in cities 
*"fire and ice" 
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The Hartli as a lUackbody 

^absorption and radiation oT solar energy 

*physics of blackbody radiation 

*thc atmospheric grconliousc 

C 1 ima t o 1 og i c a 1 Mode 1 s 

*the glass greenhouse 

*thc a tmospher ic greenhouse 

*a model of glacier growtli 

*more de ta i led c 1 i mate log leal models 

livolution of Climate 



Ap proximate l enj;lh ; Student text - - 14 0 pages 

Appendices 2 5-30 pages 
Instructor's introduction ? 

11 prograns written in BASIC are included with this package, 
status : Text is in second drafto To be compleLed sumniar 1974 
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Ti t Ic ; Models for Control of Mau*s Physical I-nvironmeat 



AulJ\o_rs : Joseph Jo Harrington 
Hnvi ronincnta J Health 

I:np,i neor i ]\\ 
Harvarcl University 



Peter P, Ropers fi 
City Planninji and 

Y'AXVc He a 1 th Hng . 
Center for Poinila- 

tiou Studies 
Harvard Univ<, 



R. Ko r^huiya 
Ilydro'-Quebec 
Mont rea 1 

(formerly Ceiiter for 
Population Studies 



Ab stract : An outgrowth of a course by the same name taught by • 
Harrington and Roj^ers for five years, the ]nirpose of ttus 
material is to accpiaint up]>er-level undergraduates \;ith the 
use of ma themat i ca 1 and coin[Hiter models currently used in 
environmental control. Models discussed are primarily 
digital computer s iniulat ions and nathenat ical prot^rammi ng , 
dealing witli equality, treatment, and control of air and 
water, land use, solid waste dis])osal, and healtli 
epidemiology. These models are organized in the material 
for classroom and laboratory computer use and homework 
assignments o 

18 programs in the BASIC language are available as part of 
the package^ 

Appr 0 xi mat e length; Student*s text 75-100 pages 

Instructor's introduction ? 
Appendices - - ? 



St a tus : Text is in second draft o Completion date uncertain. 
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TitJLe^: Invos t ipat i ons of Stack Gas Dispersion and Urban Air Pollution 
through Numerical lixorcisc 



Au thor: Yuj i Itoric 

Deptp of h'nvi ronmenta 1 Sciences fj i-ngincerint; 
School of Public Health 

University of North Carolina at Chapel Hill 



Abstrac t ; Several air pollution riodels are explained in a systematic 
fashion, with the objective of providing students Kith the 
best means for understanding; the nature of air pollution 
problems 0 Charts and graplis from which answers can be 
found are minimised, and analytical methods and the use of 
computer programs are inaximir,cdo For each topic a 
simplified version of the problem is first explained by 
means of an analytical method. The more complex and 
realistic situations are then presented in coniunction with 
computer programs. Students tluis have an option in solving 
a Riven problem and a means to check their results. An 
attempt is made to keep the matlicmatics at a level within 
the reach of most college undergraduates o Computer 
programs are fairly self-explanatory and should not cause 
any difficulty in their usoc 

Chapter 1 explains the meteorological fundamentals and the 
types of dispersion models for both reactive and non- 
reactive pollutants. The roles and practical usages of 
meteorological analysis are discussed in Chapter 2 together 
with the sources and availability of emission and 
meteorological data necessary for such analyses. Chapter 3 
focuses on the problems associated with an elevated point 
source and studies the plume behavior and ground level 
concentrations both analytically and numerically. Chapter 
4 describes the treatment of many sources and explains both 
the synoptic and climate logical models of urban air 
pollution. In Chapter 5, selected topics sucli as 
environmental capacity and control strategies are 
prosentedo 



Approximate length: Student's text--150 pages 

Appendices- -30 pages (programs) 
Ins true tor introduction— ? 

5 programs in the^ FORTRAN language are available with the package.. 



Stat us : Author^ s rough draft o Completion date uncertain^ 
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Titl e; Physics Tutorial Problem Workbook 

Author ; John Lo Jones 

Depto of Computer Science 
United States Naval Academy 

Abstract ; The workbook consists of SO tutorial problems and their 

related dia^i^rams, designed to be worked by the student in 
conjunction with a computer oporatint; in a time -sharing 
mode. The [)roblems are desii;uod to au5;ment the classroom 
instruction for an undergraduate course in general physics. 
Half the problems deal with mechanics, the other half' with 
electricity and magnetism, liach problem write-up includes 
background information, a list of problem objectives, and 
references to approin-iate sections in Sears and Hemansky, 
Halliday and Resjiick, and Sliortley and Williamso The 
package includes SO programs written in a common subset of 
the HASIC language, each of whicli leads the student through 
a given problem and gives Inm help if necessary. 

The instructor's introduction includes a discussion of the 
rationale for using such material; suggestions for 
integrating it into a course; suggestions for making the 
programs operational on the local facility (wliom to' see, 
degree of program availability, etCo); and hints on ways to 
make the programs more sophisticated for specific purposes 
(cogo, use of a driver program with teacher-generated data 
files, provision for varying initial conditions during 
subsequent exposure to the same problem, provision for 
simple record-keeping) , depending on features available on 
a given facility. Sample programs offering these features 
are appended to the teacher* s material « 

A]2proximate lengt h; Student's text 100 pages 

Instructor ' s introduct ion-- 37 pages 

4 programs in BASIC are available with this package. 

St atus ; Final draft complete; all programs written and operational » 
AVAILAHIj; TOR CLASSROOM lISi:! 
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Tit 1 e : A Computer Laboratory Manual for Number Theory 



Author: Donald 1:^ Go Malm 

Hoj^ar tr^ient of Mathematics 
Oakland Un i vers U v 



A bs t ract ; This laboratory manual is intended to supplement 
number theory. It is arrant^ed according to tojuc 



a text m 
Tor each 

the topic , its 
a set of experiments to 
work before stud>'ini; the topic; iii) a set of cxi^erimcnts 
to work while siudyinj; tl;e topic; iv) a set of more 
extensive, oiien-ended problesns; v) references to texts and 



top ic , there i s 
concepts , terms 



i) a descript ion o f 
tlieorems , etc,; i i } 



monot;rai:)lis , 
inforpia t i on 



The instructor's manual contains detailed 
on usiut; the laboratory maruial. 



Chapters: Introduction, The Ikiclidcan Algorithm and factor Lr.at ion 

into Primer, Linear DiophantiTie hquatioi^s, Congruences and 
Multiplicative Inunctions, Magic Sc[uarcs, Quadratic Residues, 
ContiiHied Fractions, lUoj^harUine liquations, Sums of Squares, 
Geometric N'umbcr Tlieory and TartitionSo 

Approximately 40 programs written in the BASIC language 
accompany the text. 



Status : Being supported summer 1974. Completion date uncertain. 
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Title : Place: A Cominiter Manual in Introductory Geography 



Auth or : Vincent I!., MalmstvtJm 

Dcj^a r tt'icnt o f Gooi\ raphy 
MidcUobury College 



Abstract ; In the first chapter, the author presents his definition of 



geogra]ihy, together Kith a brief outline of the basic 
concepts and tools ^hich the geosraphor eiuplo>'Sj giving 
special atteiUion to the potential of the conputor. The 
second cliajUer deal s with coiujuiter ina]>pi rig , g iving a stoj)- 
by-s top des c r i p t ion o f the proce dure i n solved i n 
collecting, coding, aiul print in^^ out data with a variety of 
options. In Cliaj^ter 3 various aspects of nuip analysis by 
computer arc explored, including the determination of scale 
and the ineas ure:nent of area, distance, direction, and 
central] ty. Tl\e statistical analysis of data is also 
investigated , as is the problcn of de fin i ng reg i ons by 
comiutter. Chapter 4 provides a series of exami^les of how 
the computer may be applied in pliysical gcograpliy, 
including loca t i onal de temu na t ion (1 a t i tude and 
longitude), the analysis of weather and climate data, and 
evaluation of land use potential on the basis of a physical 
inventory, in the final cliapter, some computer 
applications within the general area of cultural geography 
arc examined, with illustrative problems being drawn from 
economic, historical, and i^olitical geography. 

29 programs and 35 data files written in BASIC arc 
available as part of this package. 



Length : 



167 pages 



Status : 



Complete; 



AVAIhABLi; FOR CLASSROOM USIi! 
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Title: Models in Hcolo^y 



Author ; Jyri li^ Pal o he i mo 
Deptp of :;ooloj;y 
University of Toronto 



Abstract : A haiidbook principally designed to he part of a course in 
resource nuinagcmont , this material is the product of the 
author^s five years' ex])erience in teaching an * 
undergraduate course titled ^'Mathemat leal licology", The 
material is aimed at students whose background is primarily 
in zoology, botany, or biology, ratlier than in mathcniat ics o 
The author eases exposure to more so]:)hi st icated 
ma tliema t i cal treatments by making use of the comjniter as a 
teachi ng aid (e ^ g , , to generate vi sua 1 represent at ions of 
pojnilations and their characteristics, to examine the 
beliavior of mathematical models, to explore the patterns 
and re 1 a t ionsh i])s among data, etc 0)0 Numerous problems arc 
included in the text, some involving the use of a 
computero 

Students are led by the discussion to the point where they 
are capable of creating a program which models a single- 
species population living in a fixed resource environment 
and subject to a single form of predationa Subsequently, 
two such models are permitted to interact in order to study 
the effects of competition and the ways in wliich two- 
species systems differ from s ingl e- sp ec i es systems 0 
Eventually, students are si^own how to approach, the 
development of a model for cycling carbon, water, and 
perha])s other basic nutrients in a biosphere. The ultimate 
product is a sim]Ue ecosystem sy ntfies i r.ed from the earlier 
experiences with population models and nutrient cycles. 

The text includes the following chapters: 

Remarks for teachers 

Introduction : Ma themat ics and computers 

lo Growth and Regulation 

*demography of man and animals 
^regulation of numbers and sizes 

T 1 0 Spatial Aspects of Populations 

IIIo Theory of Search: on Prey and Predator 
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IV, Management of a Resource 
*on whales and whaling 
*arc Atlantic Salmon to survive? 

V. Biology of ropulatlons 

*a hypothetical population 

*on ecological and other indices of efficiency 
^computer paraiuecia 
^computer Daphnia 

VIo Multispecics Systems 

* CO exist once and competition 
^predatory food chain 

VIIo Ecosystem Models 

*a logistic model and beyond 

*on resource and nutrient circulation 

*a computer ecosystem 

Appendices (programs with comments) 

Approx i mat e length : Student's text — 150 pages 

Instructor's introduction ? 
Appendices - * 20 pages 

All programs are written in BASIC. 

Status: First half is in second draft; second half is in first draft 
^ Completion date uncertain^ 
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Titl^o: ACRHS: Area Community Real listato Simulation 



Author ; George lU Pi dot, Jr. 

Dcpartinenl of Hconomics 
Temple University 



Abstract : ACRHS is a yami i\g-s iiuul at ion desit;ned to give the players 

some insights into the dynamic interactions of a developin.^ 
urban area. Players representing Ihc l)usiness, 
residential, and government sectors must make a \<U\c 
variety of decisions concern lug the properties they may 
develop, thus afl'ecting the well-being of the town in which 
they are located. 

This game has been used in economics classes at Dartmouth 
and at other colleges using the Dartmouth Time-Sharing 
Sys temo 

The program is written in ANSI FORTRAN. 



Approximate length ; 12 0-14 0 pages 



Status : Preliminary version AVATLABhH FOR CLASSROOM USH. A revised 
version, reflecting changes in the game, should be available 
in the near future. 
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Title: 



Optimal Location of Facilities 



Aut hor : Gerard Rush ton 

Depart 11011 1 ot' Geojirapliy 
University of Iowa 



Abstract : This is an introductory text on ncthods for optimally 
locatin^^, facilities and on tlie preparation of data and 
control cards for conputerized Lmplementat ion of these 
methods for lar^e problems. Oriented to the undergraduate 
student with no experience in computer use, the text is 
fully sufficient to lead the student to set up and solve 
these locationa] problems both by hand (when the problems 
are small) and on the computer (when the problems are 
large). It is intended for use in undergraduate classes in 
economic and social geography, urban and regional planning 
and spatial analysiSo 

Methods are described for locating single and multiple 
facilities to minimize the average distance separating 
facilities from the locationally dispersed and 
differentially weighted demand points; to minimize the 
maximum distance to the farthest demand point; to minimize 
the total distance subject to a maximum distance 
constraint; and to find the minimum number of facilities 
required for every demand point to be within a specified 
distance of a facility, In cases whore it is more relevant 
to minimize time or cost than distance, it is shown how 
these methods can be adapted for this purpose. Distance 
minimization criteria are discvissed with reference both to 
locations in continuous space and locations on a route 
structurCo A chapter is devoted to the problem of 
comparing the shortest paths through a route structure by a 
specified combination of travel -route modes. Hach problem 
is described in verbal and mathematical terms, methods of 
solution are described, detailed computations are given for 
a handworked example, and the input form is specified for 
computer programs which solve these problems. Specimen 
control cards are described for a variety of forms in which 
the problems are foundo Homework problems are providedo 

An introductory chapter discusses applications of these 
methods to problems in both public and private sectors of 
the economy and the special problems associated with their 
use in developing count ries<, 

5 computer programs in FORTRAN are part of this package^ 
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Ap])rox iina t£ Ij* h : 160 pages 



Statu s : First draft complete; should be available in mid-summer 
1974 . 



Title ; Descriptive Statistics 



A utho r ; Harrison Do Weed, Jr^ 
Ma theiuat i c s Department 
Dartmouth College 



Abs* tract : Designed to be a supplement to standard textbooks oi\ 
elementary statistics and probabilitVo l^rovidos a 
discussion oi' metliods and their intelligent uses in 
descriptive statistics often missing in current texts, as 
well as a mucli needed Introduction for the student to 
statistical ca Icul at ions us ing the computer o Various 
methods for desc r i 1) i ng and s ummar i z ing raw data are 
discussed. Problem assignments are computer oricntedo 

Sections J Introduction, Classification of Data, Freciuency 
Distributions, Measures of Location, Measures of 
Dispers ion o 

App roxim ate l^eiu^J^^h: Student's text -- 84 pages 

Instructor ' s introduct ion ? 

Computer programs written in BASIC are available with this package. 



Status ; Preliminary versioi\ complete; should be available for 
classroom use by late summer 1974 o 
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Summer 197 4 COMPUTc Proiccts 

f: * A * 



Baircl, John CDcpartment of Psycholojjy, Dartmouth College), and 

lilliot Noma C^^^'ojli'^'^^^nior for the Social Sciences', Dartmouth 
College) 

"Psychopl\ysi cal Processes'' 

Dcrshem, Herbert C'^^P^'^'tmejit of Mathematics, Hope College) 

'Mixerclse Manual for Computer Augmented Applied Statistics 
Course" 

Lcskj Arthur (■'^^P^'^i't^i^nt of Chemistry, Pairleigh Dickinson 
University) 

''Computing Methods in Chemistry" 

Malm, Donald Co C^^cpartment of Mathematics, Oakland University) 
"A Computer Laboratory Manual for Number Theory" 

Merriam, Daniel (Department of Geology, Syracuse University) 
"Computer Fundamentals for Ceologi s ts" 

Sommer, John (Rcpartment of Geography, Dartmouth College) 

"Instructor's Text for Area Commu)nty Real listate Simulation 
Game (ACRllS) " 

(And possibly) 

Ciecka, James (DePaul University) 

"Principles of Macro- Hconomics : A Computer -Assisted Approach" 
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CONLIB*** -.LIBCAT 



ERIC 



CONLIB*** :LIBCAT 
Co ntents Of CONDUIT Pro gram [^b_rar 



Last updated May 29, 1974 by David Coolcy. 

Sununary of program names: 

Biology programs: EPOP, I:XPOP, SIGPOP, RAND-K, COMPET-1, 
COMPHT-2, C0MPI;T-5, and TUNDRA. 

Business and Economics programs: BALANCE, REARS IM, BULLPUP, 
CRIT, DECIDE, EOQ, FIPvM, HUTURE, INSYS, KEYNES, NL'\CWH, MARK, 
QUESIM, SQC, and UNISIM. 

Chemistry programs : IDFOU, ABCANAL, ABC, BOX, CONTOUR, 
DECAY- 1, DEUTI, EDTA, ENTROPY, EQUIL, ERSTLW, GENPT, UA, 
HATOM-1, iiniAG, IIMO, IDGAME, IONCH-1, IR, MAS PEC- 1, ^L^TIN\^ 
MX, NERMST, NEWTON, NMR, NONLIN, POWAC, POWID, RADIAL-1, 
RADIO, SOL-1, STOIC, and VSEPR-1. 

Mathematics programs: CIIAREQ, ECHLN, GR.AM, JACOBI, LINEAR, 
POLREG, KEDECII, and SIMPLEX, 

Utility programs: CARDFREE, FREECARD, FORMATS, DESEQ, 
FTRAN, COMMENTS, LINELEN, SEQUENCE, 

Programs with no suffix are working programs translated from 
FORTRAN to BASIC at Kiewit, Programs with a -X suffix have 
either not been thoroughly debugged or not been verified 
with test data and known results. Programs with a -1 suffix 
have been translated at Kiewit and modified by the people 
who are actually using them in classes. 

To access a program in CONLIB***, type: 

OLD CONUB*** :, program name, 

where .program name, is the name of the program as listed 
above, and then type "LIST" or "RUN" to get instructions. 

If the program has not been saved, contact the CONDUIT 
OFFICE to have the program put into CONLIB***, 
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PROGRAMS 



"EPOP" An exponential growth model for unlimited growth of a 
single species in an optimal, infinite environmento Uses 
solution of a differential equationo 

"EXPOP" This program is the same as "HPOP'* except that it 
uses an incremental addition method (difference equations). 

^•SIGPOP'' — This program is the same as "KXPOP'* with the addition 
of an environmental carrying capacity to demonstrate the 
sigmoid growth curve. 

"RAND-K" This program is an addition to "SIGPOP" which 

provides a randomly varying carrying capacity^ 

"COMPET- r' A two species competition model based on the Lotka- 
Volterra equation and using incremental addition 
(difference equations) « 

"C0MPI:T-2'' The same as »'COMPHT-r' except with graphic output. 

"COMPET-5" The same as "COMPi:T-l" with the addition of 

randomly varying carrying capacities and immigration or 
emigration based on population levels. 

"TUNDRA'* A simulation of the arctic tundra ecosystem, 

includes different species of grass, dead grass, lemmings, 
owls, and detritus. functions are separated into the three 
seasons, and real data are used to calculate the constants 
used in the program. 
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**** BUSINIivSS AND HCONOMICS PROGIIAMS **** 



•'BALANCE*' A heuristic program for solving assembly line 

balancing problems . 

•^BEARSIM'* A monte carlo simulation program which demonstrates 

the effects of various maintenance policies. 

"BULLPUP'* A macroeconomic policy game. 

"CRIT" Solves scheduling of activities within a project in 
terms of the critical path, 

"DECinn" Solves decision problems which arc structured as a 
decision tree with both decision branches and chance event 
branches . 

"EOQ" Computes the most economical inventory order quantity 

under a variety of conditions, 

"FIRM" An economic simulationo 

"FUTURE" Translates quantitative facts about the past into a 
forecast for the future o 

"INSYS" Simulation to test effect of policy changes on 

inventory levels and factory output for a 
factory-wholcsalcr-retai Icr sys tern. 

"KEYNES" A macro-economic model « 

"MACWI" Simulation based on the wharton econometric model of 
the UoSo Economy o 

'*MARK" Economics program. 

"QUESIM" A simulation program for modeling a single phase 
mult i- channel 1 queue ing system, 

"SQC" Determines whether a process is in control or not based 
on the control charts for the mean and range of a group of 
sample data. 

"UNISIiM" Simulates the decisions faced by the operations 
manager in a one-product company ^ 
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CflHMISTRY PROGIUMS ^^^^^f^^ ***** 



'•IDFOU" lixecutcs a one dimensional fovirier syntliesis or 
structure determination for a centrosymmetric' (two-atom) 
structure , 

'*ABC" Simulv'ites the IS line ABC nuclear magnetic resonenco 
spectrufio 

"ABCANA!/' rinds the analytical solution to the system 

a<=>b<=>c involving 4 rate constants. 

"BOX" Solves the one dimensional particle in a finite box 
problem, 

"CONTOUR" Calculates and prints out electron density contour 

maps for various atomic, hybrid, and molecular orbitals. 

"DKCAY-1" Simulates either simultaneous or consecutive 

radio act ive decay. 

"DERTI" A generalized data reduction ])rogram for analysis by 
titration of up to 50 data pairs, 

"liDTA" Simulates the m(2 + )-edta titration. 

"liNTROPY" Calculates the entropy of a molecule in the gas 
phase from spectroscopic datUo 

"EQUIL" Given the gas phase reaction: aa + bb<--> cc + dd 
EQUIL calculates the equilibrium constant by minimizing the 
total free energy functionc 

"FRSTLW" Program designed to aid students in the study of the 
first law of t hemodynamics o 

"HA" Simulates the weak acid - strong base titration. 

"HATOM-1" Calculates electron transitionSc 

"HMO" Uses simple Huckel molecular orbital theory to 

approximate pi molecular energy levels, wave functions, 
electron densities, bond orders and free valencies, 

"IDGAMH" A qualitative analysis game in which student tries 
to identify an organic unknown spending the least amount of 
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money for tests. 

"IONCH-1'' Calculates percent ionic character of a clipole and 
electronegativity of the two atoms. 

''IR" Searches a database of organic compounds containing the 
name, melting and boiling point and the position of the 
strongest band in the IR spectrum. 

•'MASPFC-r' Simulation of the Haling small mass spectrometer 
as described in Haling Corporation's 1969 teaching catalog. 

"NHRNST'' Simulates the potential of a m/m(z + ) electrode in an 
aqueous ammonia solution as a function of ph. 

"NEWTON'* Uses the Newton- Rapheson method for systems of 
nonlinear equations. 

"NMR'' Simulates an ab, ab2, a2b3, a2x2, or abx nuclear 
magnetic resonance spectrum. 

"NONIilN'' Does a nonlinear least squares analysis. 

**POWAC" Powder Arc Measure. Accepts the known D-spacing of 
any compound and calculates the position at which the"a^;c 
should appear on an X-ray diffraction powder film of the 
compound , 

*'POV/ID'' A searching system for ident if acnt ion of compounds 
using I)-string and intensity pairs for X-ray Powder 
Difraction Measurements. 

"RADIAL-1" Calculates and plots the radial disi-^bution 

functions for the Is , 2s ,sp, 3s , 3p , and 3d hydrogen- 1 ike 
atomic orb ital s ♦ 

"RADIO'' Calculates radio-decay curves. 

"SOL-r* Calculates the solubility of the salt mnap as a 
function of ph. 

"STOIC -- Uses the basic equation xa+yb=zc+wd and calculates 
product and reactant amounts as well as determining the 
limiting reagent , 

"VSl'PR-r' Predicts the basic geometry of certain types of 
molecules and ions. 
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MATflBlATICS PROGRAMS ^^'^a^^a^^* 



"CIIARIIQ'* I'inds the coefficients in the characteristic 

polynomial of a real matrix. 

^^ECflLN" Transforms a matrix to echelon form by elementary row 
operations . 

•^GRAM" Takes a basis of row vectors for a subspace of an n- 
tuple space, and computes un orthonormal basis of row 
vectors . 

'^JACOBI*' Diagonal izes a real synunetric matrix, 
"LINHAR" Does a linear fit of t\ data points. 

"POLRIiG" Polynomial regression anal/sis routine using the 
method of least squares. 

•'RHDIiCfl'^ Transforms a matrix t.; reduced echelon form by 
elementary row operationSo 

^'SIMPLEX" Solves a linear programming problem by the simplex 
method. 



**AA*;fc*;feA^r UTILI TY PROG RiVM S 



"CARDI'RIiM" Takes a card image Fortran program and reformats 

it into a free format Fortran suitable for DTSS Fortrano 



"FRHHCARIV' Takes a free format Fortran program in UTSS 

Fortran and forr\ats it into a card image style program 
divided according to columns 1-5,6,7-72,73-80. 



"FORMATS" Takes a card image Fortran program and moves all 
the FORMAT statements to just before tlie HND statement 
sorted in order according to their statement nuji)berSo 



"DESF:Q'' Takes a card image Fortran program with sequence' 
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numbers in cohunns 7 3-80, and removes them along with all 
the trailing spaces. 

"FTRAN" Takes a card imago Fortran program and puts out a 
Basic program with comments on the lines that it was unable 
to translate, 

"COMMliNTS" -- A quick way of getting rid of comments from a Basic 
program that was created by TTRAN. Will remove comments 
only from lines specified hy the user, 

"LINRLI-N" Checks length of lines in users current file to 
avoid "record length errors" in writing tapes with fixed 
length records. 

"SI-QUENCH" -- Checks length of lines in the users current file 
and adds sequence numbers in columns 73-80. 
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CONDUIT Staff 



1 June 1973 - 31 May 1974 



John M. Novison Project Manager 

Christopher G. Hooqondyk Chief Progran\nier and Acting Manager 



Programmers 

David Cooley - Program Librarian 

Howard S, Becker 
Andrew Behrens 
David I. Chcxuerow 
Steven Fellows 
Bruce Flaherty 
Mark Hagen 
Carey Heckman 
John C. Miller 
Richard A. Pechter 
David Roos 

William R. Schillhammer 



Slide Tape Producers 



Josh Lee 
Michelle Murray 
Spencer Reiss 
David G.S. Wood 



Secretary 

Linda M. Zoccoli 
Linda Maynard 
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Programmer ' s Weapons 



For import or export you should have a copy of Kernigham 
and Plaugor's The Elements of Pi-ogramming Styl e. The Bookstore 
sells it for $2.95. Buy it. Read it. 



Importin g a Progran) 

The goal of importing a program is to see it well used in 
a course. This means that after a program is on the system (See 
the Working Paper #7, for details.), it will be t ranslated into 
BASIC . 

If you are ready to begin, be sure you have in your hands 

1. All the available information on the program 

2. The nan\e, address, and t elephone number of the sender. 

Working Paper #4 on Editor ial Aids for I m porting and Exporting 
of Fortran Progr a ms on DTSS should help you out. Read it over, 
b efore you start . 

Other working papers listed in the appendix may also be of 
help. Check them over, before yo u start . 

After the progrcua runs and produces the correct results with 
sample data, 

1. Put a proper header on the program 

(Check Working Paper #1 for standard) 

2. Complete the internal documentation of the program 

(as well as possible) 

It may be that your program produces its correct results and is 
still a mystery to you. Don't worry about it. Imported programs 
are only guaranteed to work as advertised. CONDUIT can not doctor 
every under-explained program that is shipped in. That's the job 
of either the author or the professional (economist, chemist, 
sociologist) who uses it. 

Give a copy of the finished program to the Chief Programmer 
and tell the librarian it is ready to be put into CONLIB. 

Please keep notes on your work until you have put everythin g 
down on a Programmer's Report . 
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Exporting a Program_S c!t 

Start with the text that contains the programs. Think 
about how to write the programs according to Working Paper #1, 
Preparing a Progrcim for Export . 

1. -Make friends with the progreims 

2. -Structure thein in good BASIC or Fortran (See Reference) 

3. -Comment the progreims 

4. -Re-read the text 

5. -Write one or several Q-files (See Working Paper #2, 

Describing a Program for Export ) 

6. -Check your programs and Q-files against the seunples 

in the Working Papers for completeness . 

Finish by turning them over to the Manager and Chief Programmer 
for proof reading. 

Pleas e^ keep notes on your work until it is written down in 
a Programmer's Report . 
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CONDUIT-Dartmouth Working Papers 



Pre paring a Program for E xpor t; Christopher G. Hoogondyk, 
April 1974. ' 

2- Describing a Program for Export , John M. Nevison, 
April 1974. 

3. Agreeable Fortran , Christopher G, Hoogendyk, May 1974. 

4 • Editori a l Aids for Importing and Exportin g Fortran Programs 
on DTSS ^ Christopher G. HoogendYk, October 1973. 

5. The Export System , John M. Nevison, May 1974. 

■ How Combib Works , John M. Nevison, May 1974. 

?• Magnetic Tape Format for Exporting Programs , Christopher 
G. Hoogendyk/ May 197 4. 

8* Progr ammer's Weapons , John M. Nevison, May 1974. 

9. Isaacs, Gerald L. Intordi alect Translat ability of the Basic 

Programming La nguago , American College Testing 
Program, Bulletin No.. 11, October 1972, available 
from CONDUIT Central, Iowa City, lov/a. 

10. USA Standard Fortran (USAS X3. 9-1966) United States of America 

Standards Institute, New York, 1966. 
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27 October 1973 



Knig hts in Ru sting An nour; A Report on th e CONDUIT : 
7vct ivT£ies a'u/Tjcirtmou'S n/ Ju ne ig72-_May lTT3 (Also i 
knov;ri as Inferiui RepoTl. , Technical ; Report , or 
Regional Report), . . 



John M. Nevis on • : 
Part l-"-Introduct ion 

The follov7ing report, is dull. It will not detail any nev; 
uses of the GonVputer / it v/ill not relate any exciting 
incidents from, the classroom during the past year^ nor ■ • 
will it provide; much insight into the attitude o^f any 
participant, student or teacher,, after his run-in with ^ 
the project called CONDUIT. 

The reader interested in learning what went on in - the 
classroom is' urged to write to the participants . ^ (See 
Appendix B) . If the reader is hungry, for more he. should: : 
address his inquiries^to: the Human Resources Research 
Grganizatioh (HuinRRO) :v;hich supervised the: evaluation of . : 
: the^ lproj ect and^i is analysing: the ; results of its ;:ovv7n ,: ' 
quest ion aires . 

What this report will discuss in some detail is the first 
stijumbling efforts of a sm.ail staff at one computer center 
as it attempted to translate imported programs into, the', 
local language ■ and .make, these prog.rams useful - to teachers. 
: and students . 

The. bulk of the discussion to follow concerns problems I 
that •preoccupied the . st:af f during the school year. V It : • -. 
was a f rustrating time . ■ Firsts ; because it . took the 
coordinator four months to realize : that he. was, understaffed . 
with only Vtwo part time student programmers . Second/ . ; 
because, a lack of standards allov/ed incorrect and poorly T 
documented programs to be shipped to; the . center ■ Third, ,.; 
because the discipline committees made hurried decisions ; ; 
and in several cases selected mediocre texts. 



;: Robert Seidel 



HumRRO, Div/1, 300 N. Washington St. / Alexandria, Va.: 22314 



It was also . a: rev/ardiricf ti.rae. Some programs arrived v;ith 
exemplary' ; documentation. After an increase to six student 

.;progranraers at 'Dartmouth :the pace of technical transport 
increased from shuffle to jog. Several of the , teachers 
dramatically increased the use of computers in their 

'courses. . 

. In moving an idea from one classroom to another, moving:, 
. cpmputer programs played. a small part. Before an idea 
moved there had to exist a donor and a recipient. During 
the past year the donors v/ere the v/orkshop teachers ; 
selected by the discipline committees of the project; 
the recipients/ those v;ho attended the workshop. These ; 
v/orkshop participants \vere selected' by the: central office ■ • 
in consultci.tion v;ith the discipline comraittees. 

The participants , re turned to try the nev7 workshop ideas 
in their classes. Copies of computex' programs thcit : 
accom.panied; the ideas v;ere sent from the computer center . 
hosting the v;orkshop to each of her foux" sisters:. By the 
fir3t of September Riewit Computation. Center at Dartri^outh . , 
had, received the following sets of computer px'^ograms . : 

--Physics programs from John Merrill's; text, ^ The 
: Com puter in Second Semester" Ph ysics .. ; These px^ograms ■ 
were written originally on the- Dartmouth System and ; 
were available from the authox* or the pro ject of f ice . . 
Interested iusers, v/ere encouraged to copy these short 
prog3:ams from the book. : '■.y ---^ ■ 

.--Business and Economic: px-ograms f rbm! Oregon State 
Uniyer si ty at : Corval lis . These programs v;ere . we 11: 
: documented but not; urgently : needed. , No one: from the 
.: Dartm.outh, Region had been selected for the Business 
...Workshop. The one teachex^. who attended the Economics : : 

Workshop did not plan to use the px'-ograms until March, 
i --Linear ■ Algebra programs, f x-om the University of Iowa ^ 
:. :^ These v;ell .documented px'ograms were translated into 

: Dartmouth; Fortran in one v/eek and as quickly forgotten . 
, i The only teacher in the Dartmouth Region who had ■ • ^ 
'^attended the Workshop returned : to discover that his 
school had disconnected from the , Dartmouth Computer . 
, --Chemistry px^ograms from "the Univex^sity of Texas . . 
The poorly documented , incorrect programs lay in their 
■ card . decks - like so mtany microbes x-eady to infest ./ the 
: system with mysterious erx'ors.: ' Two teachex^s vjanted: 
:to use:; some of these :prbgrams within a month so 
translating them became: the, staff Vs first ,ef fort . ^ 
—Social Science prograiTtS did not exist. The- Social : 
: Science Committee' had not yet held its v/orkshop. A. .: 
■ local agreement with px'o.j ect IMPRESS (Interdisciplinary 
■ : Machine Processing for Research and Ed.ucation\ in the • V 
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Social Sciences) provided, fori cooperative efforts to, o 
translate appropriate texts. 

The problem that v7ould occupy the staff for. the next nine 
months was set : ; help provide the. teacher v/ith computer 
programs he /can use in his class... 

On the Dartmouth. Time-Sharing System (DTSS); almost everyone 
uses Basic, .The programs that arrived during the sunuiier ,,. 
.were, in Fortran. : In order to allov/ students and teachers " 
to alter easily a: CONDUIT program /: and to . increase the 
likelihood. of ^ the; wider adoption of a CCMDUIT proqram,, each 
one was translated from Fortran to Basic. . ' . , ; 

The cost of Table 1 is not the cost to move the program/ 
but the cost to move the program weljL, that is/ the. cost 
to. put a .program on the computer and to translate it into 
Basic. 

Even after this translation^ it must; be adi^iitted, it V7as 
not accurate to describe a program as w.ell moved. Many 
programs suffered from the inadequacies of their native 
batch processing environments. Translatect Into a good 
interactive environment they looked about as approcriate 
as a knight in full :; armour playing . split- end fbr the Dallas 
Cowboys- . 

Re-equiping : a . program for . tim.e-sharing. A-;as not . the 
responsibility of ^the CONDUIT of flee. It was the 
responsibility of : the Individual .teacher. . :The- office 
..provided .student programmers tO' on.-campus users and, at 
remote' schools r '^noney. to.; teachers .v;ho; hired - their own 
student programmers . 

This flexible teacher-student team, provided the human 
■analog to the flexible time-sharing system where a program 
could be. tailored to suit either an individual class or 
c.:v: individual student. . ■ 

The project office began with the urgently needed Chemistry 
programs , and prepared each set : of programs as they were^ 
needed. -By. the end , of the year all useful programs and ■ 
most, of the selected prograras had been translated. 



Part2"The Programs by Disciplines 
Translation Aids • 

/k. set of translation aids, was urgently needed by the Project^ 
staff. : This set 'of .programs began, in August oT 1972 and •.' • 
under\\'ent several changes during the project. : 
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.::The initial efforts during, tlie. -fail v/ere not verv successful.- 
/.The . programmer :V7ho wrote TR?\N., :a large program that . 
-.translated much of a Fortraii pr;ograiTi into. Basic/ v/as not 
.readily available to his..| feilov^ programmer who discovered ^ - 
many ^of. TilAl\f'.s bugs while .working on the Chemistry, programs. .. 

By the end .of ^February a " new chief progronmer and ^a :nev; • 
..program, FTPAI^I were both working splendidly . Five new ■ ; 
: progrcuiimers could telephone ;the chief progrimm-ier .at home" .' 

and he v/ould intnedicitely.^ f ix any bugs d.n FTll?\N from the . 

terminal at his: hom.e. In addition to FTR7U\T , the. dhief " ' • ' 

prograimner wrote, a collection of editorial aids for the 
^translation and the formatting of programs, A draft of a 

Computer Center Publication describing, those :aids is ,: 

enclosed.as Appendix C. 

The total cost of these programs \vas $548 , 53 . . This :cost 
was included in the total technical costs ot the year in . 
Table 2. because without the translating, programs the: other ^ 
w^ork would have been 'impossible . 

Chemistry 

- / . ^ "lONCH-Clarity of the progr^mi. and its ■ 
usage, vjas : seen as lacking" (From the' 
. Chemistry Workshoj? P.eport) 

:Table 3 iilustrat(^^s the yearVs success and failures in ■ ■ / 
Chemistiry The Project office initially concentrated on-" • ■ 

; the: :,.list programs that .Gillette; and Boyles requested. 

/.Af ter ' com the. of f ice concentrated . 

: on 'completing :the transiaulon of ,^all progorajiis- in K. Jeff rey 
Johnson 's " Numerical - Methods in .C hemistry:.' / (Second Edition) 
When the , book was complete ■ the '1 eftovers .v:er ci^ worked "on • 

-Some were completed and some v/ere not. - 

Ai-npng the entries . in Table 3 are some of the best and the 
v/orst programs in this year's work. The- v/orst sins v/ere • 
programs like CONTOUR,, a program that; looked good but 
; v;ould ; not run correctly. It did not run . cor recti:/ at the ' 
V7orksho.p and did not run correctly before it was sent from 
the University of Texas to Dartmouth. Worse than the fact 
that- .at.; did not run v/as the omission of any .v/srning ■ that 
it: did not ru n. The outstanding student programmer on 
the: Dartmoutli. staff :v/asted forty hours^"'trying to^ debug -a 
.■program v/i.th no bugs .. The . program did v/hat -It v;as 
.supposed to- do:., it correctly .evaluated five (5) ■ 
•Incorrect equations . That a committee -could select such 
"a program :jEor transport is a disgrace. ; 
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The; next sin of progr.Q5U transport is failure to send 
sample data and a listing of how the program should run 
. :using this data. KNEXP., P.OWAC, / and: POWJD after repeated 
■ . requests beginning in April of 1973:;: (Seven months after ' 
the workshop) -and extending through the end of. Hay still. 
..could; not be: verified at Dartmouth./ Again, the Chemistry 
Discipline Connnittee' s selection of unverified "ordgraiiis 
.. was: responsible for- v;asted ef forts, > unfulfilled" expectation 
. and , damaged reputations . . . . 

.The: third sin of program transport is a program with 
-inadequate directions on ; use ^ The: efforts of this vear 
have illustrated an obviou.s • truth : computer center 
personnel are in no position- to" describe hov; to use. 
programs in courries. Tiie natural consequence of this 
tiaith,vtha1^ op^ use. 

be fore tl iey are " seTecJt^, escap^ed the dull eyes "^cTf The 
Discipline Commxttee . At^no^jl^m^^^ the"' year ^ did 

^jlgy„_g.g.^. " - to c orrec t their initxal mistalFcs'T^lnTd'"" . 
discard bad .or poorly docvime.nted work. Hor di'd the . 
Central Office see fit to enccurge the con-tmittee to . 
monitor the use of its: programs . (Monitor , .meant m.aking : 
phone calls tv;ice during the year-to chec^k v;ith : woiOvshop^ - 
participants and coordinators on the v;orth of the ; " : 
;. selected ^progr-ams-), . .._..,.:..„.„-.^ ■ ■ ■ 

;a fourth sin of transport is a program. v;ithout a ■ 
^f lov;chart , or a . prog rein \vithout . good internal documentati.on 
.' Some selectiGns. A'/ere ,so poorly- documented that students 
.■could not improve ^the C01>JDUIt'': selection; to meet thc^^■^;^ ; ■ - : 
:;;simple ' standards^ of the vDTSS; program library . : ; ' V/ 

The Chemistry -:Conuiiittee atoned for ;many of its:..sins by " ;\ . 
selecting one of the outstanding collection of prograias ■ 
involved.'in the first year Vs activities* K. Jeffrey . :. 
Johnson' s Numeri cal^ Methods i n Chemistry v:as a delight to 
work v;i.th. There was .proper description of the subject ' 
and full documentation of all- programs in the book.:^ This 
.documentation included flow .charts, listings, san^ple data 
and runs,, and: references on the procedures ..employed. 

As the Project staff v;orked its - way down the;, list of • : ■ 
desired items; it encountered another simple ;;problem;, not 

: all the programs -v/e.re sent: by Texas/ 'So on Novemh)er 21, 
1972 , .NEVvTON , ONELEC, EI^rrROPY , CHEM20 0, CONTOUR,: lONCH, 
POWAC , POWID , : KNEXP , I DGAi-IE , POLREG , . and^' SEIDEL were ,: : 

■ requested from Texas. They v/e re promptly shipped. Nov. 27.' 

The: -S econd. Edition V7hich,: arrived at. the end ;of : February \ 
. : contai^-ied: a. correct "version p;f : CONTOUR. ■ / v; • 



For many of the above sins of transport, the r-roject paicl 
V7ith wasted time and frustrated effort. Teachers- and*" ' \ 
students also paid. Many programs were late for class, 
Some cut- the entire course. 

Another problem aiuded to earlier was making the shift 
:.,f rom batcli to interactivo programs . ; The only , per son 
Q^lified , to make , this tra}:sslation wa s the teach inq^p r o f e s s or . ^ 
James Boy ies at Bates .College paid his. student p'roq'rliimi^^ 
$77,6.3. .. He himsel f contributed majiy a.-dditional hours of 
effort to improve programs for use in his class (See the 
programs labeled "-1" in LI.BCAT. Appendix D.) Robert 
Gillette at the Naval /vcademy was not allov;ed to hire cadets 
. and so he also spent manv hours of time and effort tavloring • 
..programs to his class rTeeds. These; hours are not in Table 2.. 

Table 3 shov/s that fifteen { 1 5 ) proqrams : were not : 
successfully translated during the year of classroom 
experimentation. Hine (9) of ' these^ proqrams, v/ere 
numerical, routines with analogous programs alreadv existing : 
in the DTSS program library. Six, (6): either did not v/ork ■ . 
or lacked sample data and runs to ensure -their accuracy. 
Tv;enty-seveu (27) programs were success fully : translated. 
Twelve (12) v^ere^ used by Boyles and Gil lette ; : 

Table 2 lists the total, com.puter bill for Gillette Vs ajid- 
:Boyle's courses at^ $792 . 64:.; . This fiqure is not an accurate 
.reflection, of ^the ::totai: use of ■ the Chemistry*^roqrai:ts .V-^ 
:during the. past year. , ; Several teachers at Skidmore Coilege ' ;■: 
modified . the. Ghemi St ry ■themrih.vtheir;'^ : ^i:- ; ' 

.courses-.;;'^ -Even.: with the excessively r iarge:^ cost of ■ • : 
;transl ation \ i;t; would: be :incorreb^^ to ::as sume that , it^ over- :^ ' 
^shadowed the :'c lass use ;.of ±he pfogra:ns [ .The cost of ■ ; ' 
translation, was a ■one--time cost : and' ..those programs w^^ 
adequate documentatiohv that ; is , - 'those in Jef f - Johnson 's^ 
book., v/ill be used in succeeding years . ' - 

Casting, a- final glance at. Table 3 , one must ' note in 
conclusion that there remain a^ number of programs , 
translated but unused, batch : programs :in::.an interactive 
world, that stand like, so many knights rusting in theia: 
armour watching a gan^e they only dimly- comprehend. ^ 



Economics ■ 

One . of the first tasks to ^confront the enlarged team of 
programmers that began work in late February v^as the ■■set 
of Economics programs • . ^- 
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.,.The prograiTiG that v/ere useful to Georcfo Michaelides , . 
; BULLPUP, and MCV/IiARTOW , were not available for his class.. 
..: Some of the other prograrns / nota3:)ly , F7\CT0R-Pi\CT0I^l 11, and ■ 
. SIMPLE FIPJ--I; v;ere irappssible to run corroctly and v;ere hapoilv, 
: :discarded' v;hen instructed to by CONDUIT Central . The v . 

Economics corrumit-tee subsequently withdrev; its endorsement ; 
■ of ■ several sloppy programs:. Most of the tim.e spent on the • ' 

economics package ■ was tirae :was Led on poorly v/ritten 

programs. '^J'^'^-^- ^ avc>iced if . 

the d iscipline commir:l: ee ha d JTiysi stec- . orT'^^el'TuT' ' r urT n i n cf . 

The programs that were used by Michaelides have been :• 
ineglectcd by . the other users of DToS. This neglect . is : . 
; largely the result of the tgtal absonso of _a3i adequate 

- <3escription of ii ov7 to use . the^e pr ogr aivis in ari'ljcono]^ 

- ^Q^^^^se . " " ' , ^ -- - - - _ . - 

: In late February v.-ith the publication :of a sheet entitled 
ivorl: slioo Mate rial s the Dartmouth Of f ice v;as Informed, mucli 
to its surprise , "that an ;.1HPRESS-Iike ^workbook entitled 

^^J!^S:-Sttl^^ of ..the set of 

Economics programs- (Sec Appendix Dj ;' To' date no 
professor in the Dartmouth Region has e>:oressed anv : ■ 
interest in supervising the; translation of this wor):boo]:^ 
for the users of DTGS • 

V ■ " V ■■ " -.. .• ' ' • " : :. " ^' ' : ■ ■ : . \ " " ^ ■ ■■ .'■ ■ ■.. ' "■ . ' 

The: small flame lit by the Prc:>ject during the first lyear 
may Ave 11 ; f 1 icker ; and , die during' the^ second , -The: on].y 
hope vis that, an; 'adequate : and :^^^a 

appear; and . that this ^teKt Vviliybatch the iriteres^t^ 
a. local, 'economisty ^ ' ■ . ' 



■ Business ;, 

yThe Business programs v;ere play for the ^Project staff ; :Cne 
progran\mer having completed his other;: v/ork y spent a fev; ■ 

■hours^.brincfing up all the programs In-the booiO Computer 
jModels in Ope rations. /Mancigemeht , 

After:; these programs v/ere^comipleted a; professor at the ^ 
: Ainos \Tuck Gchool of Business ■ Administration gre\v*^ intefested 

in superyising the translation of additional: programss from 
.the. second text - in the business set , ^ Co mputer :Au gmen ted 
- Cases in Operat ions and Log ri s ties Man acrem.ent> : " ~— r- 

Like the Chemistry programs;,, ;a : ;gre at deal ' of m odi ficatio a 
v><as ne ce s s a 'ry be f o re • t h e Bus in e s s p rogram s .v:ere accept aMe 
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for use in classes. In some cases, considerably niore 
sophisticated programs already existed in th.e DTSS 
program library. 

The prograirts stand an excellent chance of being used- 
during the coming year because they have a local sponsor ' 
and becciuse they are all associated v;ith a text that 
provides^ a reasonable; discription of hov; to use the . 
programs . 

Linear /^. Igebra 

Tlie p rog r-ams in Don aid McLaiagh 1 i n * s 7^ Compute r __0r i en ted 
Courso. in Linear Algebra v-ere easy toHi aiidlc i~ I ii"" August 
of 1972 they vrero trcinsiated into Dartmouth Fortran in 
five hours- In March a programmer spent .2 3.5 more iiours 
to translate them into Basic and provide card dec]:s to 
Barrien Moore - 

Moo.re visited Hanover to speak to a conference about hov/ . 
his students had reacted to McLaughlin Vs approacli . His 
;:enthusiasm v;as catching and others , including some of , the : 
Dartmouth Mathem.atics Department , expressed interest in. v 
using some ideas in their ov;n courses. 

Moore: employed: his own student progx'ammer but received 
■money to rent a teletype and telephone for his students 
: to use du3:ing the course. 

■ The 'prog" rams-; running noW' stand ; an: excel lent - c o f ^ / ^ 

■ being" used' this year :if others ' adopt the :McLaughlin text.: . 

Physics . , ■ ■■■:>:■; 

NO: physics programs , v/ere translated during the ..year . All . 
existed : at the start .and ran in Basic/ The/ Dartmouth 
Region participants v;ere: at the University, of Nev; 
Hampshire and used the UIsI.H computer exclusively . , They 
neither asked for/ nor received / /additional help frora 
the Project office. 

Biolog y ■■■ ,,■,;■,''..;.■•■':.'' 

Tv/o copies of: David. I*7ilson's: book arrived in May of 'l9:7'->. , 
; No programs were translated. Errors in the: -prbgrams. in the ■ 

text 'v/ere discovered; by both: a programmer and the professor; 
■;. who^.reviev7ed . the/ book . .■',' 
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Because the description of "how to use the prograaTis i 
poorly org^^nized, the text will probably: not be used 
the, year 1973-1.974, in the Dartmouth Region. 



Social S cien ce 



The Social Science activities of proj ect CONDUI'j' v.^erc 
supervised by the IMPRESS^ office, under the direction of "i 
E.dniund D-^ Meyers^ director of Project IMPRESS, 

. The original, aim of this- oroject was to translate s'-ix of " 
. the nine recoiDiiiended workbooks. Two of these workbooks . 
v%^en:e available at the time of the ;October 1972. Social 
•Science Vvorkshop. Mo more w\^.re completed before the end 

■ of the year. (See ^ Appendix d.) 

It is interesting to note; that in the Coordinator 's eyes 
..the Project f ailodibecauso it failed to produce two 

additional workbooks desired by Hosenberq and Hartshorn. 
: In the Discipline Conuaittee's eyes the Dartmouth Region 
failed because all nine workbooks : were not translated . 
At no time did cuv/one ever define the trcinslation of all 
nine vjorkbooks as the Region * s responsibility , or the. ■ 
Project * s : goal> ' : " 

Given, the workbook Vs elerac n Lary approach/:it would have 
.been a waste of: time and effort^ to support any ; more than 
.the. miniinum. deemed desirable by DTSS faculty, :.;(G.:R. Boyton 
,:workGd . all; the excerises , In one; workbook in ' an shour on the ■ 
'-iMPmsS: system. )^^^^ ./■v.V'- ■ " 

- During; the; last half - o^^ the .year; the ' 'Proj ect "p ■ ; 

. student, programmer to;;h6lp prepare two addiction al work- ; ^ 
books, (See Table 1) In addition , the Project suoported : 
David Rosenberg's student assistants at ■Hiddleburv^. ' (See 
Table 2) ; - " 

The $1562 . 28 . of computer ;time under Class . Use. in Table 2 
iN^as not all the. use of the. CONDUIT databases. Other :users 
: Of IMPRESS conibined v;ith. the CONDUIT, -students to tally 
.;1.070./19002, or 5.. 6.^0, of the total IMP recorded ' 

,:for ■ the year. June 25 , 1972 to June 23/ 1973. 

Given the eno.rmous range -of the databases available on' 
IMPPiilSS and given the wide variety of sophisticated 
technigues available' for analysis^ the solid use of the • 
three .(3), COh'DUIT deitabases shou ld und erscore the pov/er - 
• . of;::an adequate v/ritten descript ion of h ow~to use~a^"p±Q gr 
in- .class , no raatter how .;e leme_ntarv . ' ' '~'~~^'; 
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This respectable usage should encourage ■ the tran'slat-: on 
of additional elementary: texts.. , David Rosenberg's 
xnf prnatxye ■ report on . his experience v/as completed on 
-July. 19, 1973. (See Appendix i\) ■ ■ " • ; 

Since June; two more of the original v/oirkbooks have b-en 
..completed. . In ..addition , David Rosenberg working o----r 
.'the .summer .with student help, is preparing ■ additiona] ' 
workbooks: for his own courses during ' the coming' vear.' .: 
Elmor .Martshcrn , has: also develooed: plans to use"' t]^e ' 
.new wor];booko in her coursos-during the coining year. '': 

P a r t 3 - •- ^ig^ca^ or]-: sho d s 

TJiree workshops" Were held on Decen>>A^>- q , •vj^r'-h Jf^ ->nd 
April 15 of the year 1972-1973. Pull, roportrha^.^ been ■ 
..lied with GOHDUIT Central. (See Appendix- A. ) 'PhPsa ' ' 
workshops encouraged wider use- of tho summer's iiPoor^-'-d 
.Ideas. Speakers included four of the eight .Natio'^a] ^ ^' 
V7ork-shop; Participants and raany otiier active teachers in ■ 
the Dartmouth Recrion. 



■ £art_j;::::i_N a-ti on al Physics VJorkshou;: ■ ' 

The^Wational, Physics V^orkshop ran -from June 19 to June 30 
1972 at Dartmouth. It was taught by John Merrill using" 
his c.vm text, ^Zlie j:c^ix^utj2-lA^ J^Ef-^oj"'^ 

f u 1 1 r e po r t h a s .■ b e e n , f i i e d , : w i t Iv CON DU IT C' en t r a "i . ■'~Ts''^( 
/vppendix A) , * 
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Part 5--Ind.e Qend£i_r^_S_va; os a n d Co nclusions 
Inde pendent S v;aps < 

Beginning in October of 1972 the Coordinators, recogni^^." ng 
thau programs of quality existed that were not officially 
included in Project CONDUIT, began an informal exchanae 
of programs. The details are elaborated in the Dartitiouth 
Coordinator s memo of October 24, 1972. (Enclosed as 
A.ppondix E . ) 

Of the eight sets listed, tv/o were from the Dartmouth 
Region; lIco3^.;_j^cuI^2oc^ Dartmouth Tlme-Sh arinq 

System by Glan?; and P.einers and T7^'^terTnTlI^.^n~R ^ 

Inves tments: New A nalv fcj^JTechrri^rn^^^^ (Praeger) wi th its 
partner jjanuals for Comimter Pro cffams in F inance and 
Investments. J3oth were snipped promptly: Tn-^arlT" 
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Noveml;Gr Pracgcr was r^cTui^stcd to send desk copies of 
Williamson's text to all joordmators . 

The Roinor's programs wore adopted at Texas and Orogon. 
Subsequent errors discovered in the biology text caused 
Roiners to iirjnodiatoly halt dis tr ibut ioru Chris lloogendyk 
working with Reiners corrected the mistakes and, after 
an April to October do Lay, the text was again approved 
for distrlbutior; • 

0. Peter Will ioiason ' s text was net, to the knowledge of 
the Dartmouth Coordinator, adopted by any otlaer Project 
office . 

Of the remaiiUng six program sets listed for swapping, 
Dartmouth never reciuestod or received two; I^xpor-Sim 
and Naylor's S imulation of .7tato Goverrmont bartmcuth 
rcvicv;ed but did not choose t6**acccpt OSU's graphing 
system because of the machine language subroutiiies and 
Snyder's Statist ical t-!othod's in lUology because no one 
here was teaching that kind of course at the time. Both 
will be reconsidered this year. 

At the joint request of David I3aldv;in in the Government 
Department at Dartmouth and David Rosenberg in the 
Department of Political Science at Middlebury both PRINCE 
from Sycause University and INS_ from North CarolinaTiave 
been translated and now work on the Dartmouth Time--Sharing 
System, PRINCK and INS work began in May of 1973 and the 
work on these programs falls outside the scope of the 
present report. 

It must be noted in passing that in addition to the 
independent swaps, publicity work, and regular classroom 
support, the Project Office engaged in a minor, and 
completely unsuccessful, trial distribution designed by 
HumRRO. A full report of that trial was made in August 
1973 (See Appendix A) • 



Conclusions 

The experience of the first year has, first, defined a 
necessary minimum for program transport. Second, it has 
suggested what an outstanding set of progrcuns should look 
like. Third, it has underscored the gross differences 
that exist between the different computing environments 
in the project. Fourth, it has sketched a preliminary 
idea for necessary standards. 

A working program needs the blessing of a wise selection 
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by the discipline conuiutteo and a porfunctory porfonnanco 
by the Projoct proyroiaiaincj stafff5. When t:ho\UBcipi ino 
coiniiutteo approved bad progranu;, the translation failed. 
When the discipline approved pro^jrams that did not have 
sample data and .sompie mnij , the translation failed. 
When the progronmuny staff at Dartmouth was undon^uninod 
the translation v;a;j intolerably delayed. 

If the discipline coniniittee selocti^ v/isely and the 
Coordinator's work is adequate/ a program' may Btlil not 
bo translated. Several prcgran^s in one Uusinofis text 
wore ignored by tl^e Dartnouth Office. The above conditions 
are not sufficient. Three good working definitions of 
what a sufficient set of progran^s should be are: 

Jeffrey Johnson's, Numerical Methods in Chemistry 
Donald McLaughlin's, A_Com|:^utor Oriented Course in ^ 

Linear A^lcjcbrg 
John Merrill's, The Com puter in Second Semester Physics 

All of these exan^ples are texts * They provide ample 
description of how to use the computer progran^s in class 

y^Qviding a detailed discussio n of the sub ject. ^n 
addition to a descriiit ion of how to use the prograir^s in 
class, each book contains prog ran is that have adequ ate 
internal docun\entat i on and, where necosGary , pro g rar;) flow 
charts , A^third important charactcrTst fcTlDf all" throe 
examples is that each includes s a m p 1 c r ui^i s o f the o r oc( r am s 
and sample data where appropriate. Fourth and most 
important, because these sets were good texts they were 
adopted by an enthusiastic, qualified teacher. 

This qualified, enthusiastic teacher is both necessary 
and sufficient to carry translated programs into his 
class. In an interactive time-shating environment a 
qualified teacher is one literate in co mputing . He knows 
how to pr tram, not necessarily to do much of'^it, but to 
smoothly pervise his student programmers. 

Even texts sufficiently prepared and ade.jUately translated 
did not always get adopted by a qualified teacher in the 
Dartmouth Region. The flexible, easy to use, time-sharing 
system often mocked the batch programs original hope of 
saving someone time and effort* Many programs translated 
by the project could have been rcv;ritten from scratcli and 
been tv;ice as useful at half the cost . 

In other words the project could have been four times as 
effective by simply mailing texts to teachers in the 
Dartmouth Region and giving each teacher an ample budget 
to hire students to do his programraing • Four is a 
conservative multiplier and the real incr eas e in benefits 
mi ght be eicjht to ten times the current scheme * This 
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conclu.siot; underscores the onourmous cli.fferenco between 
an adoqviate educational coinjnjting onvi, ronincr^ t arul tlie 
systems currently operating at some o£ the other Project 
centers . 

Because of the variety of educational onvircnuionts , 
equiprAent, lancjuacjo^ , and character codes, standards are 
needed v;ithin the Project, Experience of the past year 
has informed seyeral publications soon to be released 
by the Project. 

These docun^cnts should specify standard character codes, 
standard laagnetic tape procedures, coirxaon language 
conventions , coniraon staff progranuner procedures , and 
standard review guides. 

The past year's activity has demonstrated how not to 
transport a program. It has demonstrated how a prograiii 
micjht be transported successfully. It has sharpened the 
understanding of how a computer center publicizes good 
ideas. It has underscored the differences aiaong computing 
environments. And finally, it has suggested several' 
necessary steps to harmonize tl\e future exchange of 
progran^s . 



For information contact: 
James Johnson, Director 
Project CONDUIT 
Regional Computer Center 

University of Iowa, Iowa City, lov/a 52240 
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(Not Included) 

A. Reports from the Dartmouth Region 
Juno 1972-Octobor 1973 



B. Dartmouth Region Participants in 
Classroom Tost of Workshop Ideas 

C. Draft of a Local Publication on 
Trai^slation Aids 

D. Local Infomation on Project 
CONDUIT 

E. Program Swaps Memo 

F. Project Staff 1972-1973 
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Dartmouth-CONDUIT 
June 1, 1974 - December 31, 1974 
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